IltmmSampleTarget Interface

The Sample Target Object is accessed through the IltmmSampleTarget Interface and the IltmmObjectWrapper Interface. For more information about the IltmmObjectWrapper Interface, refer to IltmmObjectWrapper. The IltmmSampleTarget Interface lets the user set and get information about an ltmmSampleTarget object. Since the ltmmSampleTarget Interface is derived from the IDispatch Interface, the IltmmSampleTarget Interface accesses the IDispatch functions, etc. In addition to these functions, the IltmmSampleTarget Interface accesses the following functions:

Functions

IltmmSampleTarget::GetAcceptedMediaType

IltmmSampleTarget::GetConnectedMediaType

IltmmSampleTarget::GetSample

IltmmSampleTarget::SetAcceptedMediaType

A sample target will accept samples having a specific media type. This media type is set in the ltmmMediaType object, accessed through the IltmmMediaTypeDisp Interface. Once the media type is set using the IltmmMediaTypeDisp Interface, the media type for the sample target is set by calling the IltmmSampleTarget function SetAcceptedMediaType. (To determine the accepted media type of the sample target, call the GetAcceptedMediaType function.) The Sample Target object must be set to receive samples from either a Capture Object or a Convert Object and then start either the capture or the convert process. Once that is done, the sample target can begin receiving samples.

Using the GetSample function, the sample target can get delivered samples one at a time, until the end of the stream is reached. When the end of the stream is reached, the convert or capture process should be stopped. For a more detailed description of this process, refer to Implementing an ltmmSampleTarget Object.