IAMTimelineComp::VTrackInsBefore-Methode

Hinweis

[Veraltet. Diese API wird möglicherweise aus zukünftigen Releases von Windows.]

Die VTrackInsBefore -Methode fügt eine virtuelle Spur mit der angegebenen Priorität in die Komposition ein.

Syntax

HRESULT VTrackInsBefore(
   IAMTimelineObj *pVirtualTrack,
   long           Priority
);

Parameter

pVirtualTrack

Zeiger auf die IAMTimelineObj-Schnittstelle der virtuellen Spur.

Priority

Priorität, mit der die virtuelle Spur eingefügt werden soll, oder –1 zum Einfügen der virtuellen Spur am Ende der Prioritätsliste. Die Prioritätsliste bestimmt, welche Clips sichtbar sind. Weitere Informationen finden Sie unter Hinweise.

Rückgabewert

Gibt einen der folgenden HRESULT-Werte zurück:

Rückgabecode Beschreibung
S _ OK
Erfolg.
E _ INVALIDARG
Ungültiges Argument.
E _ NOINTERFACE
Das Objekt ist keine virtuelle Spur.

Hinweise

Jede virtuelle Spur in der Komposition hat eine eindeutige Prioritätsebene. Die Prioritätsebenen reichen von 0 bis n bis 1, wobei n die Anzahl virtueller Spuren in der Komposition ist. Bei Videogruppen blendet eine virtuelle Spur alle virtuellen Spuren mit einer niedrigeren Prioritätsstufe aus, außer an Stellen, an denen die Spur leer ist oder einen Übergang enthält. Sie können sich virtuelle Spuren als Ebenen in der endgültigen Komposition einordnen. Track 1 wird über Track 0 und Track 2 auf Track 1 über schichtet usw.

Wenn Sie -1 für den Priority-Parameter angeben, wird die virtuelle Spur am Ende der Liste mit einem höheren Prioritätswert als die vorhandenen Spuren eingefügt. Wenn Sie einen Prioritätswert angeben, der bereits in der Komposition vorhanden ist, wird jede Spur mit einer gleichen oder einer höheren Priorität um eine Prioritätsebene nach oben bewegt.

Beispiel: Nachverfolgung A hat Priorität 0, und Spur B hat Priorität 1. Wenn Spur C mit Priorität 0 eingefügt wird, wird A auf Priorität 1 und Nachverfolgung B auf Priorität 2 um 2.

Wenn die angegebene Priorität größer als die aktuelle Anzahl von Spuren in der Komposition ist, schlägt die Methode fehl.

Hinweis

Die Headerdatei Qedit.h ist nicht mit Direct3D-Headern nach Version 7 kompatibel.

Hinweis

Um Qedit.h zu erhalten, laden Sie das Microsoft Windows SDK-Update für Windows Vista und .NET Framework 3.0 herunter. Qedit.h ist im Microsoft Windows SDK für Windows 7 und .NET Framework 3.5 Service Pack 1 nicht verfügbar.

Anforderungen

Anforderung Wert
Header
Qedit.h
Bibliothek
Strmiids.lib

Siehe auch

IAMTimelineComp-Schnittstelle

Fehler- und Erfolgscodes