Partager via


Sous-objets

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est 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.]

[Cette API n’est pas prise en charge et peut être modifiée ou indisponible à l’avenir.]

Les sources, les effets et les transitions ont des pointeurs internes vers d’autres objets COM, appelés sous-objets. Le sous-objet effectue le travail réel de l’objet. Le sous-objet d’une source est le composant qui crée les données vidéo ou audio. Le sous-objet d’un effet ou d’une transition est le composant qui transforme les données ; par exemple, dans un effet vidéo, il crée l’effet visuel dans le flux vidéo.

Le type de sous-objet dépend du type d’objet :

  • Source : tout filtre source directShow ou filtre d’analyseur qui prend en charge la recherche et produit un format pris en charge par DES. Il peut s’agir d’un format compressé si des filtres DirectShow existent pour le décoder.
  • Effet : Pour la vidéo, n’importe quel objet Transformation Microsoft® DirectX® à entrée unique 2D. Pour l’audio, n’importe quel filtre d’effet audio DirectShow.
  • Transition : Pour la vidéo, n’importe quel objet DirectX Transform 2D à deux entrées. L’audio ne prend pas en charge les transitions.

Les groupes, les compositions et les pistes n’ont pas de sous-objets.

L’application ne définit pas directement le pointeur de sous-objet. Pour les effets et les transitions, l’application appelle la méthode IAMTimelineObj::SetSubObjectGUID pour spécifier le GUID du sous-objet. Pour les objets sources, une application appelle généralement IAMTimelineSrc::SetMediaName pour spécifier le nom d’un fichier source. Toutefois, la méthode SetSubObjectGUID peut également être utilisée pour les objets sources, afin de spécifier l’identificateur de classe (CLSID) d’un filtre.

Pour plus d’informations, consultez Utilisation des sources et Utilisation des effets et des transitions.

Vue d’ensemble des composants de chronologie