IAMTimelineComp::GetRecursiveLayerOfType-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 GetRecursiveLayerOfType -Methode führt eine Tiefenreihenfolge der in dieser Komposition enthaltenen virtuellen Spuren durch und ruft den n. virtuellen Track aus dieser Reihenfolge ab.

Syntax

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

Parameter

ppVirtualTrack [out]

Empfängt einen Zeiger auf die IAMTimelineObj-Schnittstelle der virtuellen Spur.

WhichLayer

Gibt an, welche virtuelle Spur abgerufen werden soll, die von 0 (null) indiziert wird.

Typ

Member des TIMELINE_MAJOR_TYPE aufgezählten Typs, der angibt, ob Spuren in die Suche einbezogen werden sollen.

Rückgabewert

Gibt einen der folgenden HRESULT-Werte zurück:

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_INVALIDARG	Kein Objekt des angegebenen Typs.
E_POINTER	NULL-Zeigerargument.

 

Bemerkungen

In der Regel muss eine Anwendung diese Methode nicht aufrufen.

Wenn der Type-Parameter TIMELINE_MAJOR_TYPE_TRACK ist, enthält die Tiefenreihenfolge Spuren. Andernfalls werden nur Kompositionen und Gruppen eingeschlossen. Das Objekt selbst ist in der Reihenfolge enthalten.

In der folgenden Anordnung würde die Reihenfolge beispielsweise ab Komposition A B, C, F, D, E, A sein.

Wenn die Methode erfolgreich ist, weist die zurückgegebene IAMTimelineObj-Schnittstelle eine ausstehende Verweisanzahl auf. Stellen Sie sicher, dass Sie die Schnittstelle freigeben, wenn Sie die Verwendung abgeschlossen haben.

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	Qedit.h
Bibliothek	Strmiids.lib

Siehe auch

IAMTimelineComp-Schnittstelle

Fehler- und Erfolgscodes