Metodo IFilterMapper::EnumMatchingFilters (strmif.h)

Articolo
03/02/2024

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Nota L'interfaccia IFilterMapper è deprecata. Usare invece IFilterMapper2 .

Fornisce un enumeratore che enumera i filtri registrati che soddisfano i requisiti specificati.

Sintassi

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
);

Parametri

[out] ppEnum

Indirizzo di un puntatore all'enumeratore restituito.

[in] dwMerit

Valore minimo di merito dei filtri da enumerare.

bInputNeeded

Valore che indica se deve essere presente almeno un pin di input; TRUE indica che è necessario almeno un pin di input.

[in] clsInMaj

Tipo principale di input obbligatorio. Impostare su GUID_NULL se non è importante.

[in] clsInSub

Sottotipo di input obbligatorio. Impostare su GUID_NULL se non è importante.

[in] bRender

Flag che specifica se il filtro deve eseguire il rendering dell'input; TRUE significa che deve.

[in] bOututNeeded

Valore che indica se deve essere presente almeno un pin di output; TRUE indica che è necessario almeno un pin di output.

[in] clsOutMaj

Tipo principale di output obbligatorio. Impostare su GUID_NULL se non è importante.

[in] clsOutSub

Sottotipo di output obbligatorio. Impostare su GUID_NULL se non è importante.

Valore restituito

Restituisce un valore HRESULT .

Commenti

Impostare il parametro ppEnum come enumeratore per i filtri che corrispondono ai requisiti. Per una descrizione dei valori di merito per il parametro dwMerit , vedere il metodo IFilterMapper::RegisterFilter .

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	strmif.h (include Dshow.h)

Vedi anche

Codici di errore e di esito positivo

Interfaccia IFilterMapper

Condividi tramite