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.

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

Siehe auch

Fehler- und Erfolgscodes

IFilterGraph-Schnittstelle