Categorias de filtro

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de 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 os CLSIDs para as categorias de filtro do DirectShow.

Categorias de filtro do DirectShow

As categorias listadas aqui são enumeradas pelo Mapeador de Filtros. Por padrão, no entanto, o Mapeador de Filtro 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 Dispositivo 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 de 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 de dispositivo CLSID_DeviceControlCategory MERIT_DO_NOT_USE
Filtros do DirectShow CLSID_LegacyAmFilterCategory MERIT_NORMAL
Renderizadores externos CLSID_TransmitCategory MERIT_DO_NOT_USE
Renderizadores Midi CLSID_MidiRendererCategory MERIT_NORMAL
Fontes de captura de vídeo CLSID_VideoInputDeviceCategory MERIT_DO_NOT_USE
Compressores de vídeo CLSID_VideoCompressorCategory MERIT_DO_NOT_USE
Dispositivos de descompactação de fluxo do WDM CLSID_DVDHWDecodersCategoryObservação: essa categoria contém decodificadores de DVD de hardware.
MERIT_DO_NOT_USE
Dispositivos de captura de streaming do WDM AM_KSCATEGORY_CAPTURE MERIT_DO_NOT_USE
Dispositivos de barra cruzada de streaming do WDM AM_KSCATEGORY_CROSSBAR MERIT_DO_NOT_USE
Dispositivos de renderização de streaming do WDM AM_KSCATEGORY_RENDER MERIT_DO_NOT_USE
Dispositivos tee/divisor de streaming do WDM AM_KSCATEGORY_SPLITTER MERIT_DO_NOT_USE
Dispositivos de áudio WDM Streaming TV AM_KSCATEGORY_TVAUDIO MERIT_DO_NOT_USE
Dispositivos sintonizadores de TV de streaming WDM AM_KSCATEGORY_TVTUNER MERIT_DO_NOT_USE
WDM Streaming VBI Codecs 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 do 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 do WDM KSCATEGORY_INTERFACETRANSFORM MERIT_DO_NOT_USE
Dispositivos do Mixer de Streaming do 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 do receptor BDA KSCATEGORY_BDA_RECEIVER_COMPONENT MERIT_DO_NOT_USE
Filtros de renderização do BDA KSCATEGORY_IP_SINK MERIT_DO_NOT_USE
Filtros de origem do BDA KSCATEGORY_BDA_NETWORK_TUNER MERIT_DO_NOT_USE
Renderizadores de informações de transporte do BDA KSCATEGORY_BDA_TRANSPORT_INFORMATION MERIT_NORMAL

Observação

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

Outras categorias de filtro

As categorias listadas aqui podem ser enumeradas com o Enumerador de Dispositivo do Sistema, mas não são visíveis para o Mapeador de Filtro e não são usadas pelo Intelligent Connect.

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 os Serviços de Edição do 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 Enumerando 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

Meta-Category de Filtro do DirectShow

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

Essa metacate contém uma lista de categorias de filtro. Se uma categoria de filtro não aparecer nessa lista, o Mapeador de Filtro ignorará a categoria, o que significa que o filtro não está disponível para o Intelligent Connect.

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).
"Mérito" Mérito da categoria (VT_I4). Se essa propriedade estiver ausente, trate como MERIT_DO_NOT_USE.
"CLSID" CLSID de categoria (VT_BSTR).

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

Categorias de DMO

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

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

Categoria DMO Equivalente do DirectShow
DMOCATEGORY_AUDIO_ENCODER CLSID_AudioCompressorCategory
DMOCATEGORY_AUDIO_DECODER CLSID_LegacyAmFilterCategory
DMOCATEGORY_VIDEO_ENCODER CLSID_VideoCompressorCategory
DMOCATEGORY_VIDEO_DECODER CLSID_LegacyAmFilterCategory

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

Constantes e GUIDs

Enumerando dispositivos e filtros

Conexão Inteligente

Layout das chaves do Registro

Usando o Mapeador de Filtros

Usando o Enumerador de Dispositivo do Sistema