IFilterMapper::EnumMatchingFilters-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.]

Hinweis Die IFilterMapper-Schnittstelle ist veraltet. Verwenden Sie stattdessen IFilterMapper2 .

Stellt einen Enumerator bereit, der registrierte Filter aufzählt, die die angegebenen Anforderungen erfüllen.

Syntax

HRESULT EnumMatchingFilters(
  [out] IEnumRegFilters **ppEnum,
  [in]  DWORD           dwMerit,
        BOOL            bInputNeeded,
  [in]  CLSID           clsInMaj,
  [in]  CLSID           clsInSub,
  [in]  BOOL            bRender,
  [in]  BOOL            bOututNeeded,
  [in]  CLSID           clsOutMaj,
  [in]  CLSID           clsOutSub
);

Parameter

[out] ppEnum

Adresse eines Zeigers auf den zurückgegebenen Enumerator.

[in] dwMerit

Mindestwert der zu enumerierenden Filter.

bInputNeeded

Wert, der angibt, ob mindestens ein Eingabenadel vorhanden sein muss; TRUE gibt an, dass mindestens ein Eingabenadel erforderlich ist.

[in] clsInMaj

Eingabe haupttyp erforderlich. Legen Sie auf GUID_NULL fest, wenn Sie sich nicht darum kümmern.

[in] clsInSub

Eingabeuntertyp erforderlich. Legen Sie auf GUID_NULL fest, wenn Sie sich nicht darum kümmern.

[in] bRender

Flag, das angibt, ob der Filter die Eingabe rendern muss; TRUE bedeutet, dass es muss.

[in] bOututNeeded

Wert, der angibt, ob mindestens ein Ausgabestift vorhanden sein muss; TRUE gibt an, dass mindestens ein Ausgabenadel erforderlich ist.

[in] clsOutMaj

Ausgabe-Haupttyp erforderlich. Legen Sie auf GUID_NULL fest, wenn Sie sich nicht darum kümmern.

[in] clsOutSub

Ausgabeuntertyp erforderlich. Legen Sie auf GUID_NULL fest, wenn Sie sich nicht darum kümmern.

Rückgabewert

Gibt einen HRESULT-Wert zurück.

Hinweise

Legen Sie den ppEnum-Parameter als Enumerator für Filter fest, die den Anforderungen entsprechen. Eine Beschreibung der Leistungswerte für den dwMerit-Parameter finden Sie in der IFilterMapper::RegisterFilter-Methode .

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	strmif.h (include Dshow.h)

Weitere Informationen

Fehler- und Erfolgscodes

IFilterMapper-Schnittstelle

Freigeben über