IFilterGraph::RemoveFilter-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 RemoveFilter -Methode entfernt einen Filter aus dem Diagramm.

Syntax

HRESULT RemoveFilter(
  [in] IBaseFilter *pFilter
);

Parameter

[in] pFilter

Zeiger auf den Filter, der aus dem Diagramm entfernt werden soll.

Rückgabewert

Gibt einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
S_OK	Erfolg.
E_FAIL	Fehler.
E_POINTER	NULL-Zeigerargument.

Bemerkungen

Der Filter Graph-Manager benachrichtigt den Filter, dass er entfernt wird, indem die IBaseFilter::JoinFilterGraph-Methode des Filters mit einem NULL-Argument aufgerufen wird. Es ist nicht erforderlich, die Pins des Filters zu trennen, bevor Sie aufrufen RemoveFilter, aber das Filterdiagramm sollte den Status Beendet aufweisen. Wenn die Filter nicht angehalten werden, RemoveFilter können die Pins möglicherweise nicht getrennt werden, und dann kann der Filter nicht aus dem Diagramm entfernt werden. IGraphConfig::RemoveFilterEx ermöglicht es einer Anwendung, einen Filter zu entfernen, ohne die Pins automatisch zu trennen. Dies verbessert die Leistung, wenn Sie Gruppen verbundener Filter in ein neues Diagramm verschieben möchten.

Anforderungen

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

Siehe auch

Fehler- und Erfolgscodes

IFilterGraph-Schnittstelle