Compartir a través de

Método IFilterMapper::RegisterFilterInstance (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 .
 
Registra una instancia identificable de un filtro.

Sintaxis

HRESULT RegisterFilterInstance(
  [in]  CLSID   clsid,
  [in]  LPCWSTR Name,
  [out] CLSID   *MRId
);

Parámetros

[in] clsid

GUID del filtro.

[in] Name

Nombre descriptivo de la instancia.

[out] MRId

Puntero al identificador de recurso multimedia devuelto. Este parámetro es un identificador único local para esta instancia de este filtro.

Valor devuelto

Devuelve un valor HRESULT .

Comentarios

Este método controla casos como cuando hay disponibles dos tarjetas de sonido similares controladas por el mismo controlador, y es necesario elegir qué tarjeta emitirá el sonido. Esto no es necesario si solo hay una instancia del filtro (por ejemplo, cuando solo hay una tarjeta de sonido en el equipo) o si todas las instancias del filtro son equivalentes.

El propio filtro debe haberse registrado.

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