MultiStreamTarget Class


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

public class MultiStreamTarget : IDisposable 
Public Class MultiStreamTarget  
   Implements System.IDisposable  
public ref class MultiStreamTarget : public System.IDisposable   


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:

  1. Set the number of streams by using the StreamCount property.
  2. Set the media type for all streams by calling SetAcceptedMediaType( n, …) for each stream n (n from 0 to StreamCount - 1).
  3. 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.


Target Platforms

Help Version 20.0.2020.4.2
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Multimedia Assembly