Filtrar Categorias
[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEnginee Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda vivamente que o novo código utilize MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no 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 DirectShow.
- Categorias de filtro DirectShow
- Outras categorias de filtros
- de metacategoria do filtro DirectShow
- DMO Categorias
- Tópicos relacionados
DirectShow Categorias de Filtro
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 System Device Enumerator.
As seguintes categorias 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 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 descompressão WDM Stream |
CLSID_DVDHWDecodersCategoryNota: Esta categoria contém descodificadores de DVD de hardware. |
MERIT_DO_NOT_USE |
| Dispositivos de captura de streaming WDM | AM_KSCATEGORY_CAPTURE | MERIT_DO_NOT_USE |
| Dispositivos WDM Streaming Crossbar | AM_KSCATEGORY_CROSSBAR | MERIT_DO_NOT_USE |
| Dispositivos de renderização WDM Streaming | AM_KSCATEGORY_RENDER | MERIT_DO_NOT_USE |
| Dispositivos WDM Streaming Tee/Splitter | AM_KSCATEGORY_SPLITTER | MERIT_DO_NOT_USE |
| Dispositivos de áudio WDM Streaming TV | AM_KSCATEGORY_TVAUDIO | MERIT_DO_NOT_USE |
| Dispositivos sintonizadores WDM Streaming TV | AM_KSCATEGORY_TVTUNER | MERIT_DO_NOT_USE |
| WDM Streaming VBI Codecs | AM_KSCATEGORY_VBICODEC | MERIT_DO_NOT_USE |
As seguintes categorias são declaradas no arquivo de cabeçalho Ks.h.
| Nome amigável | CLSID | Mérito |
|---|---|---|
| Transformações da comunicação de streaming WDM | KSCATEGORY_COMMUNICATIONSTRANSFORM | MERIT_DO_NOT_USE |
| Transformações de dados de streaming WDM | KSCATEGORY_DATATRANSFORM | MERIT_DO_NOT_USE |
| Transformações da interface de streaming WDM | KSCATEGORY_INTERFACETRANSFORM | MERIT_DO_NOT_USE |
| Dispositivos WDM Streaming Mixer | KSCATEGORY_MIXER | MERIT_DO_NOT_USE |
As seguintes categorias 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 |
|---|---|---|
| Fornecedores de Rede BDA | KSCATEGORY_BDA_NETWORK_PROVIDER | MERIT_NORMAL |
| Componentes do recetor BDA | KSCATEGORY_BDA_RECEIVER_COMPONENT | MERIT_DO_NOT_USE |
| Filtros de renderização BDA | KSCATEGORY_IP_SINK | MERIT_DO_NOT_USE |
| Filtros de origem 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 descodificadores estão registados na categoria "Filtros DirectShow" (CLSID_LegacyAmFilterCategory).
Outras Categorias de Filtros
As categorias listadas aqui podem ser enumeradas com o System Device Enumerator, mas não são visíveis para o Mapeador de Filtros e não são usadas pelo Intelligent Connect.
As seguintes categorias 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 |
Estas categorias contêm efeitos de vídeo e transições para DirectShow Editing Services:
- "Video Effects (1 entrada)" contém efeitos de vídeo.
- "Video Effects (2 input)" contém transições de vídeo.
Para obter mais informações, consulte enumerando efeitos e transições.
As seguintes categorias 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 |
Filtro DirectShow Meta-Category
| Nome amigável | CLSID | Mérito |
|---|---|---|
| ActiveMovie Filtrar Categorias | CLSID_ActiveMovieCategories | Não aplicável |
Esta meta-categoria contém uma lista de categorias de filtro. Se uma categoria de filtro não aparecer nessa lista, o Mapeador de Filtros ignorará a categoria, o que significa que o filtro não está disponível para 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 suportam as seguintes propriedades.
| Nome da propriedade | Descrição |
|---|---|
| "Nome Amigável" | Nome da categoria (VT_BSTR). |
| "Mérito" | Categoria mérito (VT_I4). Se esta 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.
DMO Categorias
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 System Device Enumerator para enumerar categorias DMO. Os monikers se ligam ao DMO Wrapper Filter 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 DMO | Equivalente ao 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 de efeito de vídeo e efeito de áudio não são mapeadas para nenhuma categoria do DirectShow.