Compartir a través de

Método IFilterMapper::RegisterFilter (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 .
 
Agrega un filtro al Registro; Después, se puede enumerar el filtro.

Sintaxis

HRESULT RegisterFilter(
  [in] CLSID   clsid,
  [in] LPCWSTR Name,
  [in] DWORD   dwMerit
);

Parámetros

[in] clsid

Identificador único global (GUID) del filtro.

[in] Name

Nombre descriptivo del filtro.

[in] dwMerit

Posición en el orden de enumeración. Los filtros con mayor mérito se enumeran primero.

Valor devuelto

Devuelve un valor HRESULT .

Comentarios

El mérito (definido por el parámetro dwMerit ) controla el orden en el que el administrador de gráficos de filtros intenta filtrar al realizar una operación como resultado de una llamada a IGraphBuilder::Connect, IGraphBuilder::Render o IGraphBuilder::RenderFile. El administrador de gráficos de filtros busca todos los filtros registrados con el tipo de medio correcto y, a continuación, intenta el que tiene el máximo mérito, utilizando otros criterios en el registro para elegir entre filtros con el mismo mérito.

Requisitos

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

Consulte también

Códigos de error y éxito

IFilterMapper (interfaz)

  • Last updated on