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