Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IMFMediaSink::GetStreamSinkById method

Gets a stream sink, specified by stream identifier.

Syntax


HRESULT GetStreamSinkById(
  [in]   DWORD dwStreamSinkIdentifier,
  [out]  IMFStreamSink **ppStreamSink
);

Parameters

dwStreamSinkIdentifier [in]

Stream identifier of the stream sink.

ppStreamSink [out]

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 codeDescription
S_OK

The method succeeded.

MF_E_INVALIDSTREAMNUMBER

The stream identifier is not valid.

MF_E_SHUTDOWN

The media sink's Shutdown method has been called.

 

Remarks

If you add a stream sink by calling the IMFMediaSink::AddStreamSink method, the stream identifier is specified in the dwStreamSinkIdentifier parameter of that method. If the media sink has a fixed set of streams, the media sink assigns the stream identifiers.

To enumerate the streams by index number instead of stream identifier, call IMFMediaSink::GetStreamSinkByIndex.

Requirements

Minimum supported client

Windows Vista [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2008 [desktop apps | Windows Store apps]

Header

Mfidl.h

Library

Mfuuid.lib

See also

IMFMediaSink
Media Sinks

 

 

Community Additions

Show:
© 2015 Microsoft