IAMTimelineComp::VTrackInsBefore, méthode

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

La VTrackInsBefore méthode insère une piste virtuelle dans la composition à la priorité spécifiée.

Syntaxe

HRESULT VTrackInsBefore(
   IAMTimelineObj *pVirtualTrack,
   long           Priority
);

Paramètres

pVirtualTrack

Pointeur vers l’interface IAMTimelineObj de la piste virtuelle.

Priorité

Priorité à laquelle insérer la piste virtuelle, ou –1 pour insérer la piste virtuelle à la fin de la liste des priorités. La liste des priorités détermine quels clips sont visibles. Pour plus d'informations, consultez la section Notes.

Valeur renvoyée

Retourne l’une des valeurs HRESULT suivantes :

Notes

Chaque piste virtuelle dans la composition a un niveau de priorité unique. Les niveaux de priorité vont de 0 à n - 1, où n est le nombre de pistes virtuelles dans la composition. Pour les groupes vidéo, une piste virtuelle masque toutes les pistes virtuelles avec un niveau de priorité inférieur, sauf dans les endroits où la piste est vide ou contient une transition. Vous pouvez considérer les pistes virtuelles comme des couches dans la composition finale. La piste 1 est superposée au-dessus de la piste 0, la piste 2 est superposée au-dessus de la piste 1, et ainsi de suite.

Si vous spécifiez -1 pour le paramètre Priority , la piste virtuelle est insérée à la fin de la liste, avec une valeur de priorité supérieure à celle des pistes existantes. Si vous spécifiez une valeur de priorité qui existe déjà dans la composition, chaque piste avec une priorité égale ou supérieure se déplace vers le haut d’un niveau de priorité.

Exemple : Le suivi A a la priorité 0 et le suivi B a la priorité 1. Si le suivi C est inséré à la priorité 0, le suivi A passe à la priorité 1 et le suivi B passe à la priorité 2.

Si la priorité spécifiée est supérieure au nombre actuel de pistes dans la composition, la méthode échoue.

Configuration requise

Voir aussi

IAMTimelineComp, interface

Codes d’erreur et de réussite