Présentation des classes de base de filtres
[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.]
Cet article décrit la bibliothèque de classes de base Microsoft DirectShow. Cette bibliothèque est destinée aux développeurs de filtres, mais les enregistreurs d’applications peuvent trouver certaines des classes d’assistance et utilitaires de débogage utiles. Toutefois, la bibliothèque de classes de base n’est pas requise pour la programmation DirectShow.
Les sections suivantes résument les classes de base les plus importantes de la bibliothèque.
Classes d’objets COM
Les classes suivantes prennent en charge la création d’objets COM :
| Classe | Description |
|---|---|
| CBaseObject | Classe d’objet de base. |
| CUnknown | Implémente l’interface IUnknown . |
La plupart des classes DirectShow dérivent de CBaseObject. Cette classe fournit une assistance au débogage en conservant le nombre de tous les objets actifs dans la DLL au moment de l’exécution. Dans les builds de débogage, la DLL indique si elle est déchargée alors que le nombre d’objets est supérieur à zéro. Cela facilite le suivi des fuites causées par des problèmes de comptage de références.
Toutes les classes de base qui prennent en charge les interfaces COM dérivent de CUnknown, qui hérite de CBaseObject. La classe CUnknown prend en charge le comptage de références, QueryInterface et l’agrégation. Pour plus d’informations, consultez Comment implémenter IUnknown.
Filtrer et épingler des classes
Les classes suivantes prennent en charge la création d’objets de filtre et d’épingle DirectShow :
| Classe | Description |
|---|---|
| CBaseFilter | Classe de base pour les filtres. Implémente l’interface IBaseFilter . |
| CBasePin | Classe de base pour les broches. Implémente les interfaces IPin et IQualityControl . |
| CBaseInputPin | Classe de base pour les broches d’entrée qui utilisent le transport de mémoire locale. Implémente l’interface IMemInputPin . Cette classe dérive de CBasePin. |
| CBaseOutputPin | Classe de base pour les broches de sortie qui utilisent des connexions IMemInputPin . Cette classe dérive de CBasePin. |
Les classes suivantes sont utiles pour créer des types de filtres plus spécialisés :
| Classe | Description |
|---|---|
| CSource | Classe de base pour les filtres sources. Cette classe est conçue pour créer des sources push. Il ne convient pas aux sources d’extraction, telles que les lecteurs de fichiers. Pour créer des broches de sortie pour cette classe, utilisez la classe CSourceStream . |
| CTransformFilter | Classe de base pour les filtres de transformation. Cette classe effectue une copie sur les données. Les broches de cette classe sont CTransformInputPin et CTransformOutputPin. |
| CTransInPlaceFilter | Classe de base pour les filtres de transformation qui ne copient pas de données. Cette classe effectue le traitement des données directement sur les données d’entrée avant de les transmettre en aval. Les broches de cette classe sont CTransInPlaceInputPin et CTransInPlaceOutputPin. |
| CVideoTransformFilter | Classe de base pour les filtres de transformation vidéo. Cette classe dérive de CTransformFilter et ajoute la prise en charge du contrôle qualité. |
| CBaseRenderer | Classe de base pour les filtres de convertisseur. La broche d’entrée pour cette classe est CRendererInputPin. |
| CBaseVideoRenderer | Classe de base pour les convertisseurs vidéo. Cette classe dérive de CBaseRenderer. |
Pour utiliser ces classes, vous devez dériver votre propre classe et écrire du code pour prendre en charge les fonctionnalités spécifiques à votre filtre. Plus la classe de base est spécialisée, moins vous devrez écrire de code dans votre classe dérivée.
Objets d’assistance
Les classes suivantes implémentent des objets d’assistance qui sont utilisés par les filtres et les broches. La plupart de ces classes peuvent être utilisées sans en dériver de nouvelles classes :
| Classe | Description |
|---|---|
| CPullPin | Objet d’assistance pour les broches d’entrée sur les filtres de l’analyseur. Prend en charge les connexions IAsyncReader avec des sources d’extraction. |
| COutputQueue | Objet d’assistance pour les broches de sortie qui génèrent des exemples en file d’attente pour la remise sur un thread de travail. |
| CSourceSeeking | Objet d’aide pour l’implémentation de la recherche sur un filtre source avec exactement une broche de sortie. (Cette classe n’est pas conçue pour les filtres avec plusieurs broches, comme les analyseurs.) |
| CEnumPins | Objet Énumérateur pour l’énumération des broches sur un filtre. Implémente l’interface IEnumPins . |
| CEnumMediaTypes | Objet Énumérateur pour l’énumération des types de média préférés sur une broche. Implémente l’interface IEnumMediaTypes . |
| CMemAllocator | Objet d’allocation de mémoire. Implémente l’interface IMemAllocator . |
| CMediaSample | Objet d’exemple de média. Implémente l’interface IMediaSample2 . |
| CBaseReferenceClock | Classe de base pour les horloges de référence. Implémente l’interface IReferenceClock . |
| CMediaType | Objet d’assistance pour la manipulation de structures AM_MEDIA_TYPE . |