Freigeben über


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

[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 trennt diesen Pin.

Syntax

HRESULT Disconnect(
  [in] IPin *ppin
);

Parameter

[in] ppin

Zeiger auf den Pin, der getrennt werden soll.

Rückgabewert

Gibt einen der folgenden Werte zurück.

Rückgabecode BESCHREIBUNG
S_OK
Erfolg.
S_FALSE
Der Pin war nicht verbunden. Kein Fehler.
E_FAIL
Fehler.
E_POINTER
NULL-Zeigerargument.
VFW_E_NOT_STOPPED
Der Filter wird nicht beendet, unterstützt aber keine erneute Verbindung, während sich der Status "Ausgeführt" befindet.

Hinweise

Diese Methode unterbricht die Verbindung nicht vollständig. Um die Verbindung vollständig zu unterbrechen, müssen beide Enden getrennt werden.

Um einen Filter vollständig aus dem Filterdiagramm zu entfernen, rufen Sie die IFilterGraph::RemoveFilter-Methode auf.

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

Fehler- und Erfolgscodes

IFilterGraph-Schnittstelle