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
- Autres catégories de filtres
- Méta-catégorie de filtre DirectShow
- Catégories DMO
- Rubriques connexes
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.