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
- Otras categorías de filtro
- Metacategoría de filtro DirectShow
- Categorías de DMO
- Temas relacionados
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.