IAMTimelineComp interface

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

Note

[Deprecated. This API may be removed from future releases of Windows.]

 

The IAMTimelineComp interface inserts or retrieves virtual tracks on a composition in DirectShow Editing Services (DES).

A composition is a collection of layers that acts as a single, composited track. For example, a composition that contains two tracks with a transition between them acts as a single track with the transition precomposited. A composition should contain media of only one type (such as audio or video), but this limitation is not enforced. A virtual track is any object that can reside in a composition, including tracks and other compositions.

The topmost nodes in the timeline are groups. Groups implement both the IAMTimelineComp interface and the IAMTimelineGroup interface.

To create a composition object, call IAMTimeline::CreateEmptyNode with the value TIMELINE_MAJOR_TYPE_COMPOSITE. You can query the returned IAMTimelineObj pointer for the IAMTimelineComp interface. For more information, see The Timeline Model and Constructing a Timeline.

Members

The IAMTimelineComp interface inherits from the IUnknown interface. IAMTimelineComp also has these types of members:

Methods

The IAMTimelineComp interface has these methods.

Method Description
GetCountOfType Retrieves the number of objects of a given type contained in this composition and all of its virtual tracks, recursively.
GetNextVTrack Retrieves the next virtual track after a specified virtual track.
GetRecursiveLayerOfType Performs a depth-first ordering of the virtual tracks contained in this composition, and retrieves the nth virtual track from that ordering.
GetRecursiveLayerOfTypeI Not supported.
GetVTrack Retrieves the virtual track at the specified priority.
VTrackGetCount Retrieves the number of virtual tracks contained in the composition.
VTrackInsBefore Inserts a virtual track into the composition at the specified priority.
VTrackSwapPriorities Switches the priority levels of two tracks.

 

Remarks

Note

The header file Qedit.h is not compatible with Direct3D headers later than version 7.

 

Note

To obtain Qedit.h, download the Microsoft Windows SDK Update for Windows Vista and .NET Framework 3.0. Qedit.h is not available in the Microsoft Windows SDK for Windows 7 and .NET Framework 3.5 Service Pack 1.

 

Requirements

Requirement Value
Header
Qedit.h
Library
Strmiids.lib