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
- Outras categorias de filtro
- Metacategoria de Filtro do DirectShow
- Categorias de DMO
- Tópicos relacionados
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.
Tópicos relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: ao longo de 2024, vamos eliminar problemas do GitHub como o mecanismo de comentários para conteúdo e substituí-lo por um novo sistema de comentários. Para obter mais informações, consulte:Enviar e exibir comentários de