IMFMediaSink::RemoveStreamSink-Methode (mfidl.h)

  • Artikel

Entfernt eine Streamsenke aus der Mediensenke.

Syntax

HRESULT RemoveStreamSink(
  [in] DWORD dwStreamSinkIdentifier
);

Parameter

[in] dwStreamSinkIdentifier

Bezeichner des zu entfernenden Datenstroms. Der Streambezeichner wird definiert, wenn Sie IMFMediaSink::AddStreamSink aufrufen, um die Streamsenke hinzuzufügen.

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.
E_INVALIDARG
 Diese bestimmte Streamsenke kann nicht entfernt werden.
MF_E_INVALIDSTREAMNUMBER
 Die Streamnummer ist ungültig.
MF_E_NOT_INITIALIZED
 Die Mediensenke wurde nicht initialisiert.
MF_E_SHUTDOWN
 Die Shutdown-Methode der Mediensenke wurde aufgerufen.
MF_E_STREAMSINKS_FIXED
 Diese Mediensenke verfügt über einen festen Satz von Streamsenken. Stream Senken können nicht entfernt werden.

Hinweise

Nachdem diese Methode aufgerufen wurde, ist das entsprechende Streamsenkenobjekt nicht mehr gültig. Die Methoden IMFMediaSink::GetStreamSinkByIndex und IMFMediaSink::GetStreamSinkById geben diese Streamsenke nicht mehr zurück. Sie können den Streambezeichner erneut verwenden, wenn Sie einen anderen Stream hinzufügen (durch Aufrufen von AddStreamSink).

Nicht alle Mediensenken unterstützen diese Methode. Wenn die Mediensenke diese Methode nicht unterstützt, gibt die IMFMediaSink::GetCharacteristics-Methode das flag MEDIASINK_FIXED_STREAMS zurück.

In einigen Fällen unterstützt die Mediensenke diese Methode, lässt jedoch nicht zu, dass jede Streamsenke entfernt werden kann. (Es kann z. B. nicht zulassen, dass Stream 0 entfernt wird.)

Anforderungen

Anforderung Wert
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