IMFMediaSink::RemoveStreamSink-Methode (mfidl.h)
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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Diese bestimmte Streamsenke kann nicht entfernt werden. |
|
Die Streamnummer ist ungültig. |
|
Die Mediensenke wurde nicht initialisiert. |
|
Die Shutdown-Methode der Mediensenke wurde aufgerufen. |
|
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 |