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 |
|
| Library |
|
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for