IAMTimelineTrack 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 IAMTimelineTrack interface provides methods for manipulating track objects in DirectShow Editing Services (DES).

A track contains a list of sources that are rendered in the final output. Sources within the same track may not overlap. Video tracks can have both effects and transitions. The render engine applies effects before it applies transitions. Audio tracks can have effects, but not transitions. For more information, see The Timeline Model.

To create a track object, call IAMTimeline::CreateEmptyNode with the value TIMELINE_MAJOR_TYPE_TRACK. You can query the returned IAMTimelineObj pointer for the IAMTimelineTrack interface.

Members

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

Methods

The IAMTimelineTrack interface has these methods.

Method Description
AreYouBlank Determines whether the track is blank (contains no source objects).
GetNextSrc Searches the track for the next source that appears at the specified time or later.
GetNextSrc2 Searches the track for the next source that appears at the specified time or later, with the given as a REFTIME value.
GetNextSrcEx Retrieves the next source after the specified source.
GetSourcesCount Retrieves the number of sources in the track.
GetSrcAtTime Retrieves the source object nearest to the specified time, according to the specified boundary conditions.
GetSrcAtTime2 Retrieves the source object nearest to the specified time, given as a REFTIME value.
InsertSpace Splits any objects that exist at the specified time and inserts space between them.
InsertSpace2 Splits any objects that exist at the specified time and inserts space between them, using REFTIME values.
MoveEverythingBy Not supported.
MoveEverythingBy2 Not supported.
SrcAdd Adds a source to the track.
ZeroBetween Removes everything from the track between the specified times.
ZeroBetween2 Removes everything from the track between the specified times, given as REFTIME values.

 

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