Categorie di filtro
[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation, invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.
Nelle tabelle seguenti sono elencati i CLSID per le categorie di filtri DirectShow.
- Categorie di filtri DirectShow
- Altre categorie di filtri
- Metacategoria filtro DirectShow
- Categorie DMO
- Argomenti correlati
Categorie di filtri DirectShow
Le categorie elencate di seguito sono enumerate dal Filtro mapper. Per impostazione predefinita, tuttavia, Filter Mapper ignora le categorie con meriti di MERIT_DO_NOT_USE o meno. Per altre informazioni, vedere IFilterMapper2::EnumMatchingFilters. Tutte le categorie elencate qui possono anche essere enumerate con l'enumeratore di dispositivi di sistema.
Le categorie seguenti vengono dichiarate in Uuids.h. Includere il file di intestazione Dshow.h.
| Nome descrittivo | CLSID | Merito |
|---|---|---|
| Origini di acquisizione audio | CLSID_AudioInputDeviceCategory | MERIT_DO_NOT_USE |
| Compressori audio | CLSID_AudioCompressorCategory | MERIT_DO_NOT_USE |
| Renderer audio | CLSID_AudioRendererCategory | MERIT_NORMAL |
| Filtri di controllo del dispositivo | CLSID_DeviceControlCategory | MERIT_DO_NOT_USE |
| Filtri DirectShow | CLSID_LegacyAmFilterCategory | MERIT_NORMAL |
| Renderer esterni | CLSID_TransmitCategory | MERIT_DO_NOT_USE |
| Renderer Midi | CLSID_MidiRendererCategory | MERIT_NORMAL |
| Origini di acquisizione video | CLSID_VideoInputDeviceCategory | MERIT_DO_NOT_USE |
| Compressori video | CLSID_VideoCompressorCategory | MERIT_DO_NOT_USE |
| Dispositivi di decompressione del flusso WDM | CLSID_DVDHWDecodersCategory Nota: questa categoria contiene decodificatori DVD hardware. |
MERIT_DO_NOT_USE |
| Dispositivi di acquisizione di streaming WDM | AM_KSCATEGORY_CAPTURE | MERIT_DO_NOT_USE |
| Dispositivi crossbar di streaming WDM | AM_KSCATEGORY_CROSSBAR | MERIT_DO_NOT_USE |
| Dispositivi di rendering di streaming WDM | AM_KSCATEGORY_RENDER | MERIT_DO_NOT_USE |
| Dispositivi wdm streaming tee/splitter | AM_KSCATEGORY_SPLITTER | MERIT_DO_NOT_USE |
| Dispositivi audio WDM Streaming TV | AM_KSCATEGORY_TVAUDIO | MERIT_DO_NOT_USE |
| Dispositivi di tuner WDM Streaming TV | AM_KSCATEGORY_TVTUNER | MERIT_DO_NOT_USE |
| Codec VBI di streaming WDM | AM_KSCATEGORY_VBICODEC | MERIT_DO_NOT_USE |
Le categorie seguenti vengono dichiarate nel file di intestazione Ks.h.
| Nome descrittivo | CLSID | Merito |
|---|---|---|
| Trasformazioni di comunicazione di streaming WDM | KSCATEGORY_COMMUNICATIONSTRANSFORM | MERIT_DO_NOT_USE |
| Trasformazioni di dati di streaming WDM | KSCATEGORY_DATATRANSFORM | MERIT_DO_NOT_USE |
| Trasformazioni dell'interfaccia di streaming WDM | KSCATEGORY_INTERFACETRANSFORM | MERIT_DO_NOT_USE |
| Dispositivi mixer di streaming WDM | KSCATEGORY_MIXER | MERIT_DO_NOT_USE |
Le categorie seguenti vengono dichiarate nel file di intestazione Bdamedia.h. Includere i file di intestazione seguenti: ks.h, ksmedia.h e bdamedia.h.
| Nome descrittivo | CLSID | Merito |
|---|---|---|
| Provider di rete BDA | KSCATEGORY_BDA_NETWORK_PROVIDER | MERIT_NORMAL |
| Componenti ricevitore BDA | KSCATEGORY_BDA_RECEIVER_COMPONENT | MERIT_DO_NOT_USE |
| Filtri di rendering BDA | KSCATEGORY_IP_SINK | MERIT_DO_NOT_USE |
| Filtri origine BDA | KSCATEGORY_BDA_NETWORK_TUNER | MERIT_DO_NOT_USE |
| Renderer informazioni sul trasporto BDA | KSCATEGORY_BDA_TRANSPORT_INFORMATION | MERIT_NORMAL |
Nota
I decodificatori vengono registrati nella categoria "DirectShow Filters" (CLSID_LegacyAmFilterCategory).
Altre categorie di filtri
Le categorie elencate qui possono essere enumerate con l'enumeratore di dispositivi di sistema, ma non sono visibili al mapper filtro e non vengono usate da Intelligent Connect.
Le categorie seguenti vengono dichiarate nel file di intestazione Qedit.h.
| Nome descrittivo | CLID | Merito |
|---|---|---|
| Effetti video (1 input) | CLSID_VideoEffects1Category | MERIT_DO_NOT_USE |
| Effetti video (2 input) | CLSID_VideoEffects2Category | MERIT_DO_NOT_USE |
Queste categorie contengono effetti video e transizioni per DirectShow Editing Services:
- "Effetti video (1 input)" contiene effetti video.
- "Effetti video (2 input)" contiene transizioni video.
Per altre informazioni, vedere Enumerazione di effetti e transizioni.
Le categorie seguenti vengono dichiarate nel file di intestazione Uuids.h. Includere il file di intestazione Dshow.h.
| Nome descrittivo | CLID | Merito |
|---|---|---|
| Codificatori EncAPI | CLSID_MediaEncoderCategory | MERIT_DO_NOT_USE |
| Multiplexer EncAPI | CLSID_MediaMultiplexerCategory | MERIT_DO_NOT_USE |
Metacategoria filtro DirectShow
| Nome descrittivo | CLSID | Merito |
|---|---|---|
| Categorie di filtri ActiveMovie | CLSID_ActiveMovieCategories | Non applicabile |
Questa metacategoria contiene un elenco di categorie di filtri. Se una categoria di filtro non viene visualizzata all'interno di questo elenco, Il mapper filtro ignora la categoria, il che significa che il filtro non è disponibile per Intelligent Connect.
Per enumerare l'elenco delle categorie di filtri, chiamare ICreateDevEnum::CreateClassEnumerator con il valore CLSID_ActiveMovieCategories. I moniker restituiti da questo metodo supportano le proprietà seguenti.
| Nome proprietà | Descrizione |
|---|---|
| "FriendlyName" | Nome categoria (VT_BSTR). |
| "Merito" | Merito di categoria (VT_I4). Se questa proprietà è assente, considera come MERIT_DO_NOT_USE. |
| "CLSID" | Categoria CLSID (VT_BSTR). |
Per aggiungere una nuova categoria di filtro a questo elenco, chiamare IFilterMapper2::CreateCategory.
Categorie DMO
DirectX Media Objects (DMOs) usa un meccanismo di enumerazione diverso dai filtri DirectShow. Per altre informazioni, vedere Registrazione di un DMO. Tuttavia, è possibile usare l'enumeratore di dispositivi di sistema per enumerare le categorie DMO. I moniker si associano al filtro wrapper DMO e inizializzano automaticamente il filtro con DMO.
Inoltre, alcune delle categorie DMO vengono mappate alle categorie di filtro DirectShow ai fini della connessione intelligente:
| Categoria DMO | DirectShow Equivalente |
|---|---|
| DMOCATEGORY_AUDIO_ENCODER | CLSID_AudioCompressorCategory |
| DMOCATEGORY_AUDIO_DECODER | CLSID_LegacyAmFilterCategory |
| DMOCATEGORY_VIDEO_ENCODER | CLSID_VideoCompressorCategory |
| DMOCATEGORY_VIDEO_DECODER | CLSID_LegacyAmFilterCategory |
Si noti che l'effetto video e le categorie di effetti audio non sono mappati ad alcuna categoria DirectShow.