Freigeben über

IGraphConfig::SetFilterFlags-Methode (strmif.h)

  • Artikel

[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