Partager via


Sous-objets

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngineet audio/vidéo capture dans 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 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 les filtres DirectShow existent pour le décoder.
  • Effet : Pour la vidéo, n’importe quel objet Microsoft® DirectX® Transform 2D en entrée unique. Pour l’audio, tout filtre d’effet audio DirectShow.
  • Transition : Pour la vidéo, tout 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 le 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, pour spécifier l’identificateur de classe (CLSID) d’un filtre.

Pour plus d’informations, consultez Working with Sources and Working with Effects and Transitions.

Vue d’ensemble des composants de chronologie