LEADTOOLS Multimedia (Leadtools.Multimedia assembly) Send comments on this topic. | Back to Introduction | Help Version 17.0.3.22
MultiStreamTarget Class
See Also  Members  
Leadtools.Multimedia Namespace : MultiStreamTarget Class



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

Object Model

MultiStreamTarget Class

Syntax

Visual Basic (Declaration) 
Public Class MultiStreamTarget 
   Implements IDisposable 
Visual Basic (Usage)Copy Code
Dim instance As MultiStreamTarget
C# 
public class MultiStreamTarget : IDisposable  
C++/CLI 
public ref class MultiStreamTarget : public 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:

  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.

Inheritance Hierarchy

System.Object
   Leadtools.Multimedia.MultiStreamTarget

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 2000, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7

See Also