IAMTimelineComp::GetRecursiveLayerOfType, 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 GetRecursiveLayerOfType méthode effectue un classement de profondeur d’abord des pistes virtuelles contenues dans cette composition et récupère la nièmepiste virtuelle de cet ordre.

Syntaxe

HRESULT GetRecursiveLayerOfType(
  [out] IAMTimelineObj      **ppVirtualTrack,
        long                WhichLayer,
        TIMELINE_MAJOR_TYPE Type
);

Paramètres

ppVirtualTrack [out]

Reçoit un pointeur vers l’interface IAMTimelineObj de la piste virtuelle.

WhichLayer

Spécifie la piste virtuelle à récupérer, indexée à partir de zéro.

Type

Membre du TIMELINE_MAJOR_TYPE type énuméré qui spécifie s’il faut inclure des pistes dans la recherche.

Valeur renvoyée

Retourne l’une des valeurs HRESULT suivantes :

Notes

En règle générale, une application n’a pas besoin d’appeler cette méthode.

Si le paramètre Type est TIMELINE_MAJOR_TYPE_TRACK, le classement de la profondeur d’abord inclut des pistes. Si ce n’est pas le cas, elle inclut uniquement les compositions et les groupes. L’objet lui-même est inclus dans le classement.

Par exemple, dans la disposition suivante, à partir de la composition A, le classement serait B, C, F, D, E, A.

Si la méthode réussit, l’interface IAMTimelineObj qu’elle retourne a un nombre de références en attente. Veillez à libérer l’interface lorsque vous avez terminé de l’utiliser.

Configuration requise

Voir aussi

IAMTimelineComp, interface

Codes d’erreur et de réussite