MultiStreamTarget Class

Makes it possible to fetch multiple media samples (having different media types) from the ConvertCtrl and CaptureCtrl objects.

Object Model

Syntax

Visual Basic
C#
WinRT C#
WinRT JavaScript
C++

public class MultiStreamTarget : System.IDisposable

'Declaration
 
Public Class MultiStreamTarget 
   Implements System.IDisposable

'Usage
 
Dim instance As MultiStreamTarget

public sealed class MultiStreamTarget : IClosable //In WinRT the IDisposable interface is replaced by IClosable

function Leadtools.Multimedia.MultiStreamTarget()

public ref class MultiStreamTarget : public System.IDisposable

Remarks

The MultiStreamTarget object accepts samples having different media types (each stream having its own media type) from the ConvertCtrl and CaptureCtrl objects. Specify the number of streams the object can support by using the StreamCount property.

Set the media type of each stream with the MediaType property. Use SetAcceptedMediaType method to set the media type for a specific target stream. To determine which media type is accepted from a stream, call the GetAcceptedMediaType method.

After the target for the ConvertCtrl or CaptureCtrl object is set, capturing or conversion can begin. At that point the MultiStreamTarget object can begin receiving samples. Use the WaitForSample and GetSample methods to deliver the MultiStreamTarget object samples for all streams.

When the end of the stream is reached, stop the conversion or capture process.

An overview of the whole process is as follows:

Set the number of streams by using the StreamCount property.
Set the media type for all streams by calling SetAcceptedMediaType( n, …) for each stream n (n from 0 to StreamCount – 1).
Receive samples, as follows:

a. Call WaitForSample(timeout, …) , which will return the index of the stream most recently having a sample to retrieve.

b. Call GetSample(stream, …) to retrieve the sample.

c. It may be necessary to call GetConnectedMediaType(stream, …) to learn the media type of the sample being retrieved (or retrieved).

When working with only one stream, use the SampleTarget object instead of the MultiStreamTarget object.

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

MultiStreamTarget Members
Leadtools.Multimedia Namespace