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 |
|---|---|
|
Erfolg. |
|
Fehler. |
|
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 |