IGraphConfig::SetFilterFlags-Methode (strmif.h)

Artikel
03/02/2024

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die SetFilterFlags -Methode legt die Konfigurationsinformationen eines Filters fest.

Syntax

HRESULT SetFilterFlags(
  [in] IBaseFilter *pFilter,
  [in] DWORD       dwFlags
);

Parameter

[in] pFilter

Zeiger auf die IBaseFilter-Schnittstelle eines Filters im Filterdiagramm.

[in] dwFlags

Wert, der die neuen Konfigurationsflags angibt. Dabei muss es sich um einen der folgenden Werte handeln.

Wert	BESCHREIBUNG
Null	Keine Flags festgelegt.
AM_FILTER_FLAGS_REMOVABLE	Der Filter kann während einer dynamischen Erneutverbindung entfernt werden. Weitere Informationen finden Sie in den Hinweisen.

Rückgabewert

Gibt einen der folgenden HRESULT-Werte zurück.

Rückgabecode	Beschreibung
E_POINTER	NULL-Zeigerargument.
E_INVALIDARG	Ungültiges Argument.
S_OK	Erfolg.
VFW_E_NOT_IN_GRAPH	Der Filter befindet sich nicht im Diagramm.

Hinweise

Das AM_FILTER_FLAGS_REMOVABLE-Flag ändert das Verhalten der IGraphConfig::Reconnect-Methode . Die Reconnect-Methode führt eine dynamische Erneute Verbindung zwischen zwei Pins durch. Wenn der Aufrufer einen Pin angibt, aber den anderen Pin nicht angegeben lässt, sucht reconnect Upstream oder downstream von der angegebenen Pin, um eine geeignete Übereinstimmung zu finden. Standardmäßig schlägt die Suche jedoch fehl, wenn sie einen Filter erreicht, der dem Diagramm mithilfe der IFilterGraph::AddFilter-Methode hinzugefügt wurde. Um dieses Verhalten zu überschreiben, rufen Sie SetFilterFlags auf, und legen Sie das AM_FILTER_FLAGS_REMOVABLE-Flag für den Filter fest.

Anforderungen

Anforderung	Wert
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

Weitere Informationen

Fehler- und Erfolgscodes

IGraphConfig-Schnittstelle

Freigeben über