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
- Outras categorias de filtro
- Metacategoria do filtro DirectShow
- Categorias DMO
- Tópicos relacionados
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.