IAMTimelineComp::VTrackInsBefore-Methode
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]
Hinweis
[Veraltet. Diese API kann aus zukünftigen Versionen von Windows entfernt werden.]
Die VTrackInsBefore -Methode fügt einen virtuellen Track 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, bei der der virtuelle Titel eingefügt werden soll, oder –1, um den virtuellen Titel am Ende der Prioritätsliste einzufügen. 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 |
|---|---|
|
Erfolg. |
|
Ungültiges Argument. |
|
Das Objekt ist keine virtuelle Spur. |
Bemerkungen
Jeder virtuelle Track in der Komposition hat eine eindeutige Prioritätsebene. Prioritätsstufen reichen von 0 bis n bis 1, wobei n die Anzahl der virtuellen Spuren in der Komposition ist. Bei Videogruppen blendet eine virtuelle Spur alle virtuellen Spuren mit einer niedrigeren Prioritätsebene aus, außer an Stellen, an denen der Titel leer ist oder einen Übergang enthält. Sie können sich virtuelle Tracks als Ebenen in der endgültigen Komposition vorstellen. Track 1 ist über Track 0, Track 2 über Gleis 1 und so weiter.
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 gleicher oder höherer Priorität um eine Prioritätsebene nach oben verschoben.
Beispiel: Track A hat Priorität 0, und Spur B hat Priorität 1. Wenn Titel C mit Priorität 0 eingefügt wird, wird die Spur A auf Priorität 1 verschoben, und Track B wird auf Priorität 2 verschoben.
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 ab 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 |
|
| Bibliothek |
|
Siehe auch