Categorías de filtro

[La característica asociada a esta página, DirectShow es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine, y Captura de audio y 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 useMediaPlayer, IMFMediaEngine y Captura de audio y vídeo en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft recomienda reescribir el código actual que usa las API heredadas 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, consulte 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éritos
Fuentes 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
Fuentes de captura de video CLSID_VideoInputDeviceCategory MERIT_DO_NOT_USE
Compresores de video CLSID_VideoCompressorCategory MERIT_DO_NOT_USE
Dispositivos de descompresión de flujos de WDM CLSID_DVDHWDecodersCategory Nota: 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/Splitter de streaming de WDM AM_KSCATEGORY_SPLITTER MERIT_DO_NOT_USE
Dispositivos de audio de Streaming TV 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éritos
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éritos
Proveedores de red 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 fuentes 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 de DirectShow" (CLSID_LegacyAmFilterCategory).

Otras categorías de filtro

Las categorías aquí enumeradas 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éritos
Efectos de video (1 entrada) CLSID_VideoEffects1Category MERIT_DO_NOT_USE
Efectos de video (2 entradas) CLSID_VideoEffects2Category MERIT_DO_NOT_USE

Estas categorías contienen efectos de video y transiciones para Servicios de edición de DirectShow:

  • "Efectos de video (1 entrada)" contiene efectos de video.
  • "Efectos de video (2 entradas)" contiene transiciones de video.

Para obtener más información, consulte 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éritos
Codificadores EncAPI CLSID_MediaEncoderCategory MERIT_DO_NOT_USE
Multiplexadores EncAPI CLSID_MediaMultiplexerCategory MERIT_DO_NOT_USE

Metacategoría de filtro DirectShow

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

Esta metacategoría contiene una lista de categorías de filtro. Si no aparece una categoría de filtro 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 la categoría (VT_BSTR).
"Merit" 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 Registrar un DMO. Sin embargo, puede usar el enumerador de dispositivos del sistema para enumerar categorías DMO. Los monikers se enlazan al Filtro de contenedor de 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 con fines de conexión inteligente:

Categoría DMO Equivalente de DirectShow
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 video y efecto de audio no se asignan a ninguna categoría directShow.

Constantes y GUID

Enumerar dispositivos y filtros

Intelligent Connect

Diseño de las claves del registro

Uso del asignador de filtros

Uso del enumerador de dispositivos del sistema