Método IFilterMapper::EnumMatchingFilters (strmif.h)

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

Nota La interfaz IFilterMapper está en desuso. En su lugar, use IFilterMapper2 .

 

Proporciona un enumerador que enumera los filtros registrados que cumplen los requisitos especificados.

Sintaxis

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

Parámetros

[out] ppEnum

Dirección de un puntero al enumerador devuelto.

[in] dwMerit

Valor mínimo de mérito de los filtros que se van a enumerar.

bInputNeeded

Valor que indica si debe haber al menos un pin de entrada; TRUE indica que se requiere al menos un pin de entrada.

[in] clsInMaj

Se requiere el tipo principal de entrada. Establézcalo en GUID_NULL si no le importa.

[in] clsInSub

Subtipo de entrada necesario. Establézcalo en GUID_NULL si no le importa.

[in] bRender

Marca que especifica si el filtro debe representar la entrada; TRUE significa que debe.

[in] bOututNeeded

Valor que indica si debe haber al menos un pin de salida; TRUE indica que se requiere al menos un pin de salida.

[in] clsOutMaj

Se requiere el tipo principal de salida. Establézcalo en GUID_NULL si no le importa.

[in] clsOutSub

Subtipo de salida necesario. Establézcalo en GUID_NULL si no le importa.

Valor devuelto

Devuelve un valor HRESULT .

Comentarios

Establezca el parámetro ppEnum para que sea un enumerador para los filtros que coincidan con los requisitos. Para obtener una descripción de los valores de mérito para el parámetro dwMerit , consulte el método IFilterMapper::RegisterFilter .

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	strmif.h (incluya Dshow.h)

Consulte también

Códigos de error y éxito

IFilterMapper (interfaz)