IGraphConfig::RemoveFilterEx-Methode (strmif.h)

Artikel
07/28/2023

[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 RemoveFilterEx -Methode entfernt einen Filter aus dem Filterdiagramm.

Syntax

HRESULT RemoveFilterEx(
  [in] IBaseFilter *pFilter,
  [in] DWORD       Flags
);

Parameter

[in] pFilter

Zeiger auf die IBaseFilter-Schnittstelle des Filters, der aus dem Diagramm entfernt werden soll.

[in] Flags

Kombination von Flags aus dem REM_FILTER_FLAGS aufgezählten Typ.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK oder einen HRESULT-Wert zurück, der die Ursache des Fehlers angibt.

Bemerkungen

Diese Methode erweitert die IFilterGraph::RemoveFilter-Methode , indem sie ein Flag akzeptiert, das das Verhalten der Methode angibt. Dieses Flag ermöglicht es einer Anwendung, einen Filter zu entfernen, ohne die Pins automatisch zu trennen, was die Leistung beim Verschieben von Gruppen verbundener Filter in ein neues Diagramm verbessert.

Standardmäßig trennt diese Methode den Filter, bevor er aus dem Diagramm entfernt wird. Verwenden Sie das flag REMFILTERF_LEAVECONNECTED, um den Filter verbunden zu lassen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	strmif.h (include Dshow.h)
Bibliothek	Strmiids.lib

Siehe auch

Fehler- und Erfolgscodes

IGraphConfig-Schnittstelle

Freigeben über