MFPMediaItem_SetStreamSink

Sets a media sink for the media item. A media sink is an object that consumes the data from one or more streams.

MFPMediaItem_SetStreamSink PROTO pMediaItem:DWORD, dwStreamIndex:DWORD, pMediaSink:DWORD

Parameters

  • pMediaItem - A pointer to the Media Item (IMFPMediaItem) object.

  • dwStreamIndex - Zero-based index of a stream on the media source. The media sink will receive the data from this stream.

  • pMediaSink - IUnknown pointer that specifies the media sink. Pass in one of the following:

    • A pointer to a stream sink. Every media sink contains one or more stream sinks. Each stream sink receives the data from one stream. The stream sink must expose the IMFStreamSink interface.

    • A pointer to an activation object that creates the media sink. The activation object must expose the IMFActivate interface. The media item uses the first stream sink on the media sink (that is, the stream sink at index 0).

    • NULL. If you set pMediaSink to NULL, the default media sink for the stream type is used.

Returns

TRUE if successful or FALSE otherwise.

Notes

By default, the MFPlay player object renders audio streams to the Streaming Audio Renderer (SAR) and video streams to the Enhanced Video Renderer (EVR).

Call this method before calling MFPMediaPlayer_SetMediaItem. Calling this method after MFPMediaPlayer_SetMediaItem has no effect, unless you stop playback and call MFPMediaPlayer_SetMediaItem again.

To reset the media item to use the default media sink, set pMediaSink to NULL

See Also

MFPMediaPlayer_SetMediaItem