Partager via


Filtrer les catégories

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Elle a été remplacée par MediaPlayer, IMFMediaEngine et Capture audio/vidéo dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Si possible, Microsoft recommande vivement d’utiliser MediaPlayer, IMFMediaEngine et Capture audio/vidéo dans Media Foundation pour le nouveau code, plutôt que DirectShow. Microsoft recommande, si possible, la réécriture du code existant qui utilise les API héritées pour être à jour avec les nouvelles API.]

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

Catégories de filtre DirectShow

Les catégories listées ici sont énumérées par ordre de mappeur de filtres. Toutefois, par défaut, le mappeur de filtre ignore les catégories avec un mérite de MERIT_DO_NOT_USE ou inférieur. Pour en savoir plus, consultez IFilterMapper2::EnumMatchingFilters. L'ensemble des catégories listées ici peuvent également être énumérées avec l’énumérateur d’appareil 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
Sources de capture audio 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_DVDHWDecodersCategory Remarque : cette catégorie inclut les décodeurs DVD physiques.
MERIT_DO_NOT_USE
Appareils de capture de streaming WDM AM_KSCATEGORY_CAPTURE MERIT_DO_NOT_USE
Appareils de la matrice de commutation de streaming WDM AM_KSCATEGORY_CROSSBAR MERIT_DO_NOT_USE
Appareils de rendu de streaming WDM AM_KSCATEGORY_RENDER MERIT_DO_NOT_USE
Séparateurs/Tee de streaming WDM AM_KSCATEGORY_SPLITTER MERIT_DO_NOT_USE
Appareil audio de streaming TV WDM AM_KSCATEGORY_TVAUDIO MERIT_DO_NOT_USE
Tuners de streaming TV WDM AM_KSCATEGORY_TVTUNER MERIT_DO_NOT_USE
Codecs VBI de streaming WDM 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 de streaming WDM KSCATEGORY_COMMUNICATIONSTRANSFORM MERIT_DO_NOT_USE
Transformations de données de streaming WDM KSCATEGORY_DATATRANSFORM MERIT_DO_NOT_USE
Transformations de l’interface de streaming WDM KSCATEGORY_INTERFACETRANSFORM MERIT_DO_NOT_USE
Appareils de mixage de streaming WDM 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, and bdamedia.h.

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

Remarque

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

Autres catégories de filtres

Les catégories listées ici peuvent être énumérées avec l’énumérateur d’appareil système, mais ne sont pas visibles par le mappeur de filtres et ne sont pas utilisées par la Connexion intelligente.

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 les services de montage vidéo DirectShow :

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

Pour en savoir plus, 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
Encodeurs EncAPI CLSID_MediaEncoderCategory MERIT_DO_NOT_USE
Multiplexeurs EncAPI CLSID_MediaMultiplexerCategory MERIT_DO_NOT_USE

Méta-catégorie de filtre DirectShow

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

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

Pour obtenir la liste des catégories de filtres, appelez ICreateDevEnum::CreateClassEnumerator avec la valeur CLSID_ActiveMovieCategories. Les monikers renvoyé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).
"Merit" Mérite de catégorie (VT_I4). Si cette propriété est absente, partez du principe qu'il s'agit de 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 en savoir plus, consultez Enregistrer un DMO. Vous pouvez cependant utiliser l’énumérateur d’appareil 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.

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

Catégorie DMO Équivalent DirectShow
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’effet vidéo et d’effet audio ne sont pas mappées à des catégories DirectShow.

Constantes et GUID

Énumérer des appareils et des filtres

Connexion intelligente

Disposition des clés de Registre

Utiliser le mappeur de filtres

Utiliser l’énumérateur d’appareil système