Categorias de filtro

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído pelo MediaPlayer, IMFMediaEngine e Captura de áudio/vídeo no Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o MediaPlayer, o IMFMediaEngine e a Captura de áudio/vídeo no Media Foundation em vez do DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

As tabelas a seguir listam as CLSIDs para as categorias de filtro DirectShow.

Categorias de filtro DirectShow

As categorias listadas aqui são enumeradas pelo Mapeador de Filtros. Por padrão, no entanto, o Mapeador de Filtros ignora categorias com méritos de MERIT_DO_NOT_USE ou menos. Para obter mais informações, consulte IFilterMapper2::EnumMatchingFilters. Todas as categorias listadas aqui também podem ser enumeradas com o Enumerador de Dispositivos do Sistema.

As categorias a seguir são declaradas em Uuids.h. Inclua o arquivo de cabeçalho Dshow.h.

Nome Amigável CLSID Mérito
Fontes da captura de áudio CLSID_AudioInputDeviceCategory MERIT_DO_NOT_USE
Compressores de áudio CLSID_AudioCompressorCategory MERIT_DO_NOT_USE
Renderizadores de áudio CLSID_AudioRendererCategory MERIT_NORMAL
Filtros de controle do dispositivo CLSID_DeviceControlCategory MERIT_DO_NOT_USE
Filtros DirectShow CLSID_LegacyAmFilterCategory MERIT_NORMAL
Renderizadores externos CLSID_TransmitCategory MERIT_DO_NOT_USE
Renderizadores Midi CLSID_MidiRendererCategory MERIT_NORMAL
Fontes da captura de vídeo CLSID_VideoInputDeviceCategory MERIT_DO_NOT_USE
Compressores de vídeo CLSID_VideoCompressorCategory MERIT_DO_NOT_USE
Dispositivos de descompactação do fluxo WDM CLSID_DVDHWDecodersCategory Observação: Esta categoria contém decodificadores de DVD de hardware.
MERIT_DO_NOT_USE
Dispositivos de captura de streaming WDM AM_KSCATEGORY_CAPTURE MERIT_DO_NOT_USE
Dispositivos de barra cruzada de streaming WDM AM_KSCATEGORY_CROSSBAR MERIT_DO_NOT_USE
Dispositivos de renderização de streaming WDM AM_KSCATEGORY_RENDER MERIT_DO_NOT_USE
Dispositivos de transmissão de tê/divisor WDM AM_KSCATEGORY_SPLITTER MERIT_DO_NOT_USE
Dispositivos de áudio de TV com streaming WDM AM_KSCATEGORY_TVAUDIO MERIT_DO_NOT_USE
Dispositivos sintonizadores de streaming de TV WDM AM_KSCATEGORY_TVTUNER MERIT_DO_NOT_USE
Codecs VBJ de streaming WDM AM_KSCATEGORY_VBICODEC MERIT_DO_NOT_USE

As categorias a seguir são declaradas no arquivo de cabeçalho Ks.h.

Nome Amigável CLSID Mérito
Transformações de comunicação de streaming WDM KSCATEGORY_COMMUNICATIONSTRANSFORM MERIT_DO_NOT_USE
Transformações de dados de streaming do WDM KSCATEGORY_DATATRANSFORM MERIT_DO_NOT_USE
Transformações da interface de streaming WDM KSCATEGORY_INTERFACETRANSFORM MERIT_DO_NOT_USE
Dispositivos de mixer de streaming WDM KSCATEGORY_MIXER MERIT_DO_NOT_USE

As categorias a seguir são declaradas no arquivo de cabeçalho Bdamedia.h. Inclua os seguintes arquivos de cabeçalho: ks.h, ksmedia.h e bdamedia.h.

Nome Amigável CLSID Mérito
Provedores de rede BDA KSCATEGORY_BDA_NETWORK_PROVIDER MERIT_NORMAL
Componentes de receptor BDA KSCATEGORY_BDA_RECEIVER_COMPONENT MERIT_DO_NOT_USE
Filtros de renderização BDA KSCATEGORY_IP_SINK MERIT_DO_NOT_USE
Filtros de fonte BDA KSCATEGORY_BDA_NETWORK_TUNER MERIT_DO_NOT_USE
Renderizadores de informações de transporte BDA KSCATEGORY_BDA_TRANSPORT_INFORMATION MERIT_NORMAL

Observação

Os decodificadores são registrados na categoria "Filtros DirectShow" (CLSID_LegacyAmFilterCategory).

Outras categorias de filtro

As categorias listadas aqui podem ser enumeradas com o Enumerador de Dispositivos do Sistema, mas não são visíveis para o Mapeador de Filtros e não são usadas pela Conexão Inteligente.

As categorias a seguir são declaradas no arquivo de cabeçalho Qedit.h.

Nome Amigável CLID Mérito
Efeitos de vídeo (1 entrada) CLSID_VideoEffects1Category MERIT_DO_NOT_USE
Efeitos de vídeo (2 entradas) CLSID_VideoEffects2Category MERIT_DO_NOT_USE

Essas categorias contêm efeitos de vídeo e transições para Serviços de edição DirectShow:

  • "Efeitos de vídeo (1 entrada)" contém efeitos de vídeo.
  • "Efeitos de vídeo (2 entradas)" contém transições de vídeo.

Para obter mais informações, consulte Enumeração de efeitos e transições.

As categorias a seguir são declaradas no arquivo de cabeçalho Uuids.h. Inclua o arquivo de cabeçalho Dshow.h.

Nome Amigável CLID Mérito
Codificadores EncAPI CLSID_MediaEncoderCategory MERIT_DO_NOT_USE
Multiplexadores EncAPI CLSID_MediaMultiplexerCategory MERIT_DO_NOT_USE

Metacategoria do filtro DirectShow

Nome Amigável CLSID Mérito
Categorias de filtro ActiveMovie CLSID_ActiveMovieCategories Não aplicável

Esta metacategoria contém uma lista de categorias do filtro. Se uma categoria de filtro não aparecer nessa lista, o Mapeador de Filtros vai ignorar a categoria, o que significa que o filtro não está disponível para a Conexão inteligente.

Para enumerar a lista de categorias de filtro, chame ICreateDevEnum::CreateClassEnumerator com o valor CLSID_ActiveMovieCategories. Os monikers retornados por esse método dão suporte às propriedades a seguir.

Nome da propriedade Descrição
"FriendlyName" Nome da categoria (VT_BSTR).
"Merit" Mérito da categoria (VT_I4). Se essa propriedade estiver ausente, trate como MERIT_DO_NOT_USE.
"CLSID" Categoria CLSID (VT_BSTR).

Para adicionar uma nova categoria de filtro a essa lista, chame IFilterMapper2::CreateCategory.

Categorias DMO

Os Objetos de Mídia DirectX (DMOs) usam um mecanismo de enumeração diferente dos filtros DirectShow. Para obter mais informações, consulte Registro de um DMO. No entanto, você pode usar o Enumerador de Dispositivos do Sistema para enumerar categorias DMO. Os monikers se associam ao Filtro de Wrapper DMO e inicializam automaticamente o filtro com o DMO.

Além disso, algumas das categorias DMO são mapeadas para categorias de filtro DirectShow para fins de conexão inteligente:

Categoria de DMO Equivalente a DirectShow
DMOCATEGORY_AUDIO_ENCODER CLSID_AudioCompressorCategory
DMOCATEGORY_AUDIO_DECODER CLSID_LegacyAmFilterCategory
DMOCATEGORY_VIDEO_ENCODER CLSID_VideoCompressorCategory
DMOCATEGORY_VIDEO_DECODER CLSID_LegacyAmFilterCategory

As categorias de efeito de vídeo e efeito de áudio não são mapeadas para nenhuma categoria do DirectShow.

Constantes e GUIDs

Enumeração de dispositivos e filtros

Conexão inteligente

Layout das chaves do Registro

Uso do Mapeador de Filtros

Uso do Enumerador de dispositivo do sistema