Categorías de filtro

  • Artículo

[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.

En las tablas siguientes se enumeran los CLSID para las categorías de filtro DirectShow.

Categorías de filtro directShow

Las categorías enumeradas aquí se enumeran mediante el asignador de filtros. Sin embargo, de forma predeterminada, el asignador de filtros omite las categorías con méritos de MERIT_DO_NOT_USE o menos. Para obtener más información, vea IFilterMapper2::EnumMatchingFilters. Todas las categorías enumeradas aquí también se pueden enumerar con el enumerador de dispositivos del sistema.

Las siguientes categorías se declaran en Uuids.h. Incluya el archivo de encabezado Dshow.h.

Nombre descriptivo CLSID Mérito
Orígenes de captura de audio CLSID_AudioInputDeviceCategory MERIT_DO_NOT_USE
Compresores de audio CLSID_AudioCompressorCategory MERIT_DO_NOT_USE
Representadores de audio CLSID_AudioRendererCategory MERIT_NORMAL
Filtros de control de dispositivos CLSID_DeviceControlCategory MERIT_DO_NOT_USE
Filtros directShow CLSID_LegacyAmFilterCategory MERIT_NORMAL
Representadores externos CLSID_TransmitCategory MERIT_DO_NOT_USE
Representadores midi CLSID_MidiRendererCategory MERIT_NORMAL
Orígenes de captura de vídeo CLSID_VideoInputDeviceCategory MERIT_DO_NOT_USE
Compresores de vídeo CLSID_VideoCompressorCategory MERIT_DO_NOT_USE
Dispositivos de descompresión de secuencias de WDM CLSID_DVDHWDecodersCategoryNota: Esta categoría contiene descodificadores de DVD de hardware.
 MERIT_DO_NOT_USE
Dispositivos de captura de streaming de WDM AM_KSCATEGORY_CAPTURE MERIT_DO_NOT_USE
Dispositivos de barra cruzada de streaming de WDM AM_KSCATEGORY_CROSSBAR MERIT_DO_NOT_USE
Dispositivos de representación de streaming de WDM AM_KSCATEGORY_RENDER MERIT_DO_NOT_USE
Dispositivos de tee/divisor de streaming de WDM AM_KSCATEGORY_SPLITTER MERIT_DO_NOT_USE
Dispositivos de audio de TV de streaming de WDM AM_KSCATEGORY_TVAUDIO MERIT_DO_NOT_USE
Dispositivos de sintonizador de TV de streaming de WDM AM_KSCATEGORY_TVTUNER MERIT_DO_NOT_USE
Códecs VBI de streaming de WDM AM_KSCATEGORY_VBICODEC MERIT_DO_NOT_USE

Las siguientes categorías se declaran en el archivo de encabezado Ks.h.

Nombre descriptivo CLSID Mérito
Transformaciones de comunicación de streaming de WDM KSCATEGORY_COMMUNICATIONSTRANSFORM MERIT_DO_NOT_USE
Transformaciones de datos de streaming de WDM KSCATEGORY_DATATRANSFORM MERIT_DO_NOT_USE
Transformaciones de interfaz de streaming de WDM KSCATEGORY_INTERFACETRANSFORM MERIT_DO_NOT_USE
Dispositivos mezcladores de streaming de WDM KSCATEGORY_MIXER MERIT_DO_NOT_USE

Las siguientes categorías se declaran en el archivo de encabezado Bdamedia.h. Incluya los siguientes archivos de encabezado: ks.h, ksmedia.h y bdamedia.h.

Nombre descriptivo CLSID Mérito
Proveedores de red de BDA KSCATEGORY_BDA_NETWORK_PROVIDER MERIT_NORMAL
Componentes del receptor BDA KSCATEGORY_BDA_RECEIVER_COMPONENT MERIT_DO_NOT_USE
Filtros de representación de BDA KSCATEGORY_IP_SINK MERIT_DO_NOT_USE
Filtros de origen de BDA KSCATEGORY_BDA_NETWORK_TUNER MERIT_DO_NOT_USE
Representadores de información de transporte de BDA KSCATEGORY_BDA_TRANSPORT_INFORMATION MERIT_NORMAL

Nota:

Los descodificadores se registran en la categoría "Filtros directShow" (CLSID_LegacyAmFilterCategory).

Otras categorías de filtro

Las categorías enumeradas aquí se pueden enumerar con el enumerador de dispositivos del sistema, pero no son visibles para el asignador de filtros y no se usan en Intelligent Connect.

Las siguientes categorías se declaran en el archivo de encabezado Qedit.h.

Nombre descriptivo CLID Mérito
Efectos de vídeo (1 entrada) CLSID_VideoEffects1Category MERIT_DO_NOT_USE
Efectos de vídeo (2 entradas) CLSID_VideoEffects2Category MERIT_DO_NOT_USE

Estas categorías contienen efectos de vídeo y transiciones para DirectShow Editing Services:

  • "Efectos de vídeo (1 entrada)" contiene efectos de vídeo.
  • "Efectos de vídeo (2 entrada)" contiene transiciones de vídeo.

Para obtener más información, vea Enumerar efectos y transiciones.

Las siguientes categorías se declaran en el archivo de encabezado Uuids.h. Incluya el archivo de encabezado Dshow.h.

Nombre descriptivo CLID Mérito
Codificadores encAPI CLSID_MediaEncoderCategory MERIT_DO_NOT_USE
Multiplexores encAPI CLSID_MediaMultiplexerCategory MERIT_DO_NOT_USE

DirectShow Filter Meta-Category

Nombre descriptivo CLSID Mérito
Categorías de filtro ActiveMovie CLSID_ActiveMovieCategories No aplicable

Esta meta categoría contiene una lista de categorías de filtros. Si una categoría de filtro no aparece dentro de esta lista, el asignador de filtros omite la categoría, lo que significa que el filtro no está disponible para Intelligent Connect.

Para enumerar la lista de categorías de filtro, llame a ICreateDevEnum::CreateClassEnumerator con el valor CLSID_ActiveMovieCategories. Los monikers devueltos por este método admiten las siguientes propiedades.

Nombre de propiedad Descripción
"FriendlyName" Nombre de categoría (VT_BSTR).
"Mérito" Mérito de categoría (VT_I4). Si esta propiedad no está presente, trate como MERIT_DO_NOT_USE.
"CLSID" CLSID de categoría (VT_BSTR).

Para agregar una nueva categoría de filtro a esta lista, llame a IFilterMapper2::CreateCategory.

Categorías de DMO

Los objetos multimedia (DPO) de DirectX usan un mecanismo de enumeración diferente de los filtros DirectShow. Para obtener más información, consulte Registro de un DMO. Sin embargo, puede usar el enumerador de dispositivos del sistema para enumerar las categorías de DMO. Los monikers se enlazan al filtro contenedor DMO e inicializan automáticamente el filtro con DMO.

Además, algunas de las categorías de DMO se asignan a las categorías de filtro directShow para los fines de la conexión inteligente:

Categoría DMO DirectShow equivalente
DMOCATEGORY_AUDIO_ENCODER CLSID_AudioCompressorCategory
DMOCATEGORY_AUDIO_DECODER CLSID_LegacyAmFilterCategory
DMOCATEGORY_VIDEO_ENCODER CLSID_VideoCompressorCategory
DMOCATEGORY_VIDEO_DECODER CLSID_LegacyAmFilterCategory

Tenga en cuenta que las categorías de efectos de vídeo y de audio no se asignan a ninguna categoría de DirectShow.

Constantes y GUID

Enumeración de dispositivos y filtros

Conexión inteligente

Diseño de las claves del Registro

Usar el asignador de filtros

Uso del enumerador de dispositivos del sistema