IMFMediaSink::GetStreamSinkByIndex method

Gets a stream sink, specified by index.

Syntax

HRESULT GetStreamSinkByIndex(
  DWORD         dwIndex,
  IMFStreamSink **ppStreamSink
);

Parameters

dwIndex

Zero-based index of the stream. To get the number of streams, call IMFMediaSink::GetStreamSinkCount.

ppStreamSink

Receives a pointer to the stream's IMFStreamSink interface. The caller must release the interface.

Return Value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
The method succeeded.
MF_E_INVALIDINDEX
Invalid index.
MF_E_SHUTDOWN
The media sink's Shutdown method has been called.

Remarks

Enumerating stream sinks is not a thread-safe operation, because stream sinks can be added or removed between calls to this method.

Requirements

   
Minimum supported client Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 [desktop apps | UWP apps]
Target Platform Windows
Header mfidl.h
Library Mfuuid.lib

See Also

IMFMediaSink

Media Sinks