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