←Select platform

MultiStreamTarget Class

Summary

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

Syntax

C++

public class MultiStreamTarget : System.IDisposable

Public Class MultiStreamTarget  
   Implements System.IDisposable

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