IMFMediaSink::GetStreamSinkById-Methode (mfidl.h)

Ruft eine Streamsenke ab, die durch den Streambezeichner angegeben wird.

Syntax

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

Parameter

[in] dwStreamSinkIdentifier

Streambezeichner der Streamsenke.

[out] ppStreamSink

Empfängt einen Zeiger auf die IMFStreamSink-Schnittstelle des Streams. Der Aufrufer muss die Schnittstelle freigeben.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
Die Methode wurde erfolgreich ausgeführt.
MF_E_INVALIDSTREAMNUMBER
Der Streambezeichner ist ungültig.
MF_E_SHUTDOWN
Die Shutdown-Methode der Mediensenke wurde aufgerufen.

Hinweise

Wenn Sie eine Streamsenke hinzufügen, indem Sie die IMFMediaSink::AddStreamSink-Methode aufrufen, wird der Streambezeichner im dwStreamSinkIdentifier-Parameter dieser Methode angegeben. Wenn die Mediensenke über einen festen Satz von Datenströmen verfügt, weist die Mediensenke die Datenstrombezeichner zu.

Rufen Sie IMFMediaSink::GetStreamSinkByIndex auf, um die Streams nach Indexnummer anstelle des Streambezeichners aufzulisten.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfidl.h
Bibliothek Mfuuid.lib

Weitere Informationen

IMFMediaSink

Mediensenken