Définition des propriétés sur les sources

  • Article

[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.]

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

Lorsque vous créez un objet source, vous devez définir quelques propriétés et d’autres que vous pouvez éventuellement définir. Vous devez définir les propriétés suivantes.

  • Heures de début et d’arrêt, par rapport au reste du chronologie. Appelez la méthode IAMTimelineObj::SetStartStop . Ne définissez pas de temps de chevauchement sur les objets sources dans la même piste, sinon cela provoquera un comportement non défini.
  • Fichier multimédia à utiliser comme clip source. Appelez IAMTimelineSrc::SetMediaName.
  • Heures de démarrage et d’arrêt du média, par rapport au fichier source d’origine. Appelez la méthode IAMTimelineSrc::SetMediaTimes . Exception : si la source est une image fixe, ne spécifiez pas les heures de média. Pour plus d’informations sur les temps multimédias, consultez Time in DirectShow Editing Services.

Un objet source hérite de son type de média du groupe parent. Il n’est donc pas nécessaire de spécifier un type de média.

Les propriétés facultatives sont les suivantes :

  • Mode stretch. Le mode stretch spécifie comment Microsoft® DirectShow® Editing Services (DES) affiche une source dont la taille ne correspond pas aux dimensions de sortie. Par défaut, DES étire une image sans conserver les proportions. Vous pouvez également rogner une image ou créer une boîte aux lettres. Appelez la méthode IAMTimelineSrc::SetStretchMode pour spécifier le mode stretch.
  • Durée du fichier source. Si vous définissez cette propriété avant de définir les heures du média, DES valide l’heure d’arrêt du média et tronque l’heure d’arrêt si elle dépasse la durée du fichier. Cela peut vous aider à éviter les erreurs de rendu ultérieurement. Vous pouvez obtenir la durée du fichier à l’aide du détecteur de média, comme décrit dans Utilisation du détecteur de média. Appelez la méthode IAMTimelineSrc::SetMediaLength pour spécifier la durée du fichier.
  • Numéro de flux. Par défaut, un objet source utilise le premier flux du fichier qui correspond au type de média du groupe parent. Si un fichier contient au moins deux flux du même type de média, sélectionnez le flux à utiliser en appelant IAMTimelineSrc::SetStreamNumber. Vous pouvez utiliser le détecteur de média pour rechercher le nombre de flux.

Utilisation de sources