IPin::D isconnect-Methode (strmif.h)

  • Artikel

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die Disconnect -Methode unterbricht die aktuelle Pinverbindung.

Der Filter Graph-Manager ruft diese Methode auf, wenn zwei Filter getrennt werden. Anwendungen und Filter sollten diese Methode nicht aufrufen. Rufen Sie stattdessen die IFilterGraph::D isconnect-Methode im Filter Graph-Manager auf.

Syntax

HRESULT Disconnect();

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Rückgabecode Beschreibung
S_FALSE
 Der Pin war nicht verbunden.
S_OK
 Erfolg.
VFW_E_NOT_STOPPED
 Der Filter ist aktiv.

Hinweise

Diese Methode schlägt fehl, wenn der Filter angehalten oder ausgeführt wird. Wenn der Pin die IPinConnection-Schnittstelle unterstützt, rufen Sie IPinConnection::D ynamicDisconnect auf, um die Verbindung zu trennen, wenn der Filter angehalten oder ausgeführt wird.

Diese Methode trennt den anderen Pin in der Pinverbindung nicht.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile strmif.h (include Dshow.h)
Bibliothek Strmiids.lib

Weitere Informationen

Datenfluss im Filtergraphen

Fehler- und Erfolgscodes

IPin-Schnittstelle