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

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.

Costanti e GUID

Enumerazione di dispositivi e filtri

Intelligent Connect

Layout delle chiavi del Registro di sistema

Uso del mapper filtro

Uso dell'enumeratore di dispositivi di sistema