Filtrer les catégories

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

Les tableaux suivants répertorient les CLSID pour les catégories de filtre DirectShow.

Catégories de filtre DirectShow

Les catégories répertoriées ici sont énumérées par le mappeur de filtre. Toutefois, par défaut, le mappeur de filtre ignore les catégories ayant des mérites de MERIT_DO_NOT_USE ou moins. Pour plus d’informations, consultez IFilterMapper2::EnumMatchingFilters. Toutes les catégories répertoriées ici peuvent également être énumérées avec l’énumérateur d’appareils système.

Les catégories suivantes sont déclarées dans Uuids.h. Incluez le fichier d’en-tête Dshow.h.

Nom convivial CLSID Mérite
Audio Capture Sources CLSID_AudioInputDeviceCategory MERIT_DO_NOT_USE
Compresseurs audio CLSID_AudioCompressorCategory MERIT_DO_NOT_USE
Convertisseurs audio CLSID_AudioRendererCategory MERIT_NORMAL
Filtres de contrôle d’appareil CLSID_DeviceControlCategory MERIT_DO_NOT_USE
Filtres DirectShow CLSID_LegacyAmFilterCategory MERIT_NORMAL
Convertisseurs externes CLSID_TransmitCategory MERIT_DO_NOT_USE
Convertisseurs Midi CLSID_MidiRendererCategory MERIT_NORMAL
Sources de capture vidéo CLSID_VideoInputDeviceCategory MERIT_DO_NOT_USE
Compresseurs vidéo CLSID_VideoCompressorCategory MERIT_DO_NOT_USE
Appareils de décompression de flux WDM CLSID_DVDHWDecodersCategoryRemarque : cette catégorie contient des décodeurs de DVD matériels.
MERIT_DO_NOT_USE
Appareils de capture de streaming WDM AM_KSCATEGORY_CAPTURE MERIT_DO_NOT_USE
Appareils à barres croisées de streaming WDM AM_KSCATEGORY_CROSSBAR MERIT_DO_NOT_USE
Périphériques de rendu de streaming WDM AM_KSCATEGORY_RENDER MERIT_DO_NOT_USE
WDM Streaming Tee/Splitter Devices AM_KSCATEGORY_SPLITTER MERIT_DO_NOT_USE
Périphériques audio WDM Streaming TV AM_KSCATEGORY_TVAUDIO MERIT_DO_NOT_USE
WDM Streaming TV Tuner Devices AM_KSCATEGORY_TVTUNER MERIT_DO_NOT_USE
WDM Streaming VBI Codecs AM_KSCATEGORY_VBICODEC MERIT_DO_NOT_USE

Les catégories suivantes sont déclarées dans le fichier d’en-tête Ks.h.

Nom convivial CLSID Mérite
Transformations de communication en streaming WDM KSCATEGORY_COMMUNICATIONSTRANSFORM MERIT_DO_NOT_USE
Transformations de données WDM Streaming KSCATEGORY_DATATRANSFORM MERIT_DO_NOT_USE
Transformations de l’interface de streaming WDM KSCATEGORY_INTERFACETRANSFORM MERIT_DO_NOT_USE
WDM Streaming Mixer Devices KSCATEGORY_MIXER MERIT_DO_NOT_USE

Les catégories suivantes sont déclarées dans le fichier d’en-tête Bdamedia.h. Incluez les fichiers d’en-tête suivants : ks.h, ksmedia.h et bdamedia.h.

Nom convivial CLSID Mérite
Fournisseurs réseau BDA KSCATEGORY_BDA_NETWORK_PROVIDER MERIT_NORMAL
Composants du récepteur BDA KSCATEGORY_BDA_RECEIVER_COMPONENT MERIT_DO_NOT_USE
Filtres de rendu BDA KSCATEGORY_IP_SINK MERIT_DO_NOT_USE
Filtres sources BDA KSCATEGORY_BDA_NETWORK_TUNER MERIT_DO_NOT_USE
Convertisseurs d’informations de transport BDA KSCATEGORY_BDA_TRANSPORT_INFORMATION MERIT_NORMAL

Notes

Les décodeurs sont inscrits sous la catégorie « Filtres directShow » (CLSID_LegacyAmFilterCategory).

Autres catégories de filtres

Les catégories répertoriées ici peuvent être énumérées avec l’énumérateur de périphérique système, mais ne sont pas visibles par le mappeur de filtres et ne sont pas utilisées par Intelligent Connect.

Les catégories suivantes sont déclarées dans le fichier d’en-tête Qedit.h.

Nom convivial CLID Mérite
Effets vidéo (1 entrée) CLSID_VideoEffects1Category MERIT_DO_NOT_USE
Effets vidéo (2 entrées) CLSID_VideoEffects2Category MERIT_DO_NOT_USE

Ces catégories contiennent des effets vidéo et des transitions pour DirectShow Editing Services :

  • « Effets vidéo (1 entrée) » contient des effets vidéo.
  • « Effets vidéo (2 entrées) » contient des transitions vidéo.

Pour plus d’informations, consultez Énumération des effets et des transitions.

Les catégories suivantes sont déclarées dans le fichier d’en-tête Uuids.h. Incluez le fichier d’en-tête Dshow.h.

Nom convivial CLID Mérite
EncAPI Encoders CLSID_MediaEncoderCategory MERIT_DO_NOT_USE
Multiplexeurs EncAPI CLSID_MediaMultiplexerCategory MERIT_DO_NOT_USE

DirectShow Filter Meta-Category

Nom convivial CLSID Mérite
Catégories de filtres ActiveMovie CLSID_ActiveMovieCategories Non applicable

Cette méta-catégorie contient une liste de catégories de filtres. Si aucune catégorie de filtre n’apparaît dans cette liste, le mappeur de filtre ignore la catégorie, ce qui signifie que le filtre n’est pas disponible pour Intelligent Connect.

Pour énumérer la liste des catégories de filtres, appelez ICreateDevEnum::CreateClassEnumerator avec la valeur CLSID_ActiveMovieCategories. Les monikers retournés par cette méthode prennent en charge les propriétés suivantes.

Nom de la propriété Description
« FriendlyName » Nom de la catégorie (VT_BSTR).
« Mérite » Mérite de catégorie (VT_I4). Si cette propriété est absente, traitez comme MERIT_DO_NOT_USE.
« CLSID » CLSID de catégorie (VT_BSTR).

Pour ajouter une nouvelle catégorie de filtre à cette liste, appelez IFilterMapper2::CreateCategory.

Catégories DMO

Les objets multimédias DirectX (DMO) utilisent un mécanisme d’énumération différent des filtres DirectShow. Pour plus d’informations, consultez Inscription d’un DMO. Toutefois, vous pouvez utiliser l’énumérateur d’appareils système pour énumérer les catégories DMO. Les monikers sont liés au filtre wrapper DMO et initialisent automatiquement le filtre avec le DMO.

En outre, certaines catégories DMO sont mappées aux catégories de filtre DirectShow à des fins de connexion intelligente :

Catégorie DMO DirectShow Equivalent
DMOCATEGORY_AUDIO_ENCODER CLSID_AudioCompressorCategory
DMOCATEGORY_AUDIO_DECODER CLSID_LegacyAmFilterCategory
DMOCATEGORY_VIDEO_ENCODER CLSID_VideoCompressorCategory
DMOCATEGORY_VIDEO_DECODER CLSID_LegacyAmFilterCategory

Notez que les catégories d’effets vidéo et d’effets audio ne sont pas mappées à des catégories DirectShow.

Constantes et GUID

Énumération des appareils et des filtres

Connexion intelligente

Disposition des clés de Registre

Utilisation du mappeur de filtre

Utilisation de l’énumérateur de périphérique système