IAMTimeline 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 IAMTimeline interface provides methods for manipulating the timeline, the central object in Microsoft DirectShow Editing Services (DES). A timeline is a collection of time-ordered elements, such as video clips, audio clips, effects, and transitions between clips. The render engine uses the timeline to create a filter graph, from which the application can generate the rendered output.
IAMTimeline performs three basic services. It
- Creates the objects in the timeline.
- Acts as a container for those objects.
- Sets and retrieves general parameters of the timeline.
To create the timeline object, call CoCreateInstance with the class identifier CLSID_AMTimeline.
Members
The IAMTimeline interface inherits from the IUnknown interface. IAMTimeline also has these types of members:
Methods
The IAMTimeline interface has these methods.
| Method | Description |
|---|---|
| AddGroup | Adds a group to the timeline. |
| ClearAllGroups | Removes all groups from the timeline, along with all objects contained in those groups. |
| CreateEmptyNode | Creates a new timeline object. |
| EffectsEnabled | Determines whether effects are enabled. |
| EnableEffects | Enables or disables all effects in the timeline. |
| EnableTransitions | Enables or disables all transitions in the timeline. |
| GetCountOfType | Retrieves the number of objects of the specified type that are contained in a specified group and all of its children. |
| GetDefaultEffect | Retrieves the default effect. |
| GetDefaultEffectB | Retrieves the default effect as a BSTR value. |
| GetDefaultFPS | Retrieves the default output frame rate, in frames per second. |
| GetDefaultTransition | Retrieves the default transition. |
| GetDefaultTransitionB | Retrieves the default transition as a BSTR value. |
| GetDirtyRange | Not supported. |
| GetDuration | Retrieves the timeline duration. |
| GetDuration2 | Retrieves the timeline duration as a double. |
| GetGroup | Retrieves a specified group. |
| GetGroupCount | Retrieves the number of groups that are contained in the timeline. |
| GetInsertMode | Not supported. |
| IsDirty | Not supported. |
| RemGroupFromList | Not supported. |
| SetDefaultEffect | Sets the default effect. |
| SetDefaultEffectB | Sets the default effect as a BSTR value. |
| SetDefaultFPS | Sets the default output frame rate, in frames per second. |
| SetDefaultTransition | Sets the default transition. |
| SetDefaultTransitionB | Sets the default transition as a BSTR value. |
| SetInsertMode | Not implemented. |
| SetInterestRange | Not implemented. |
| TransitionsEnabled | Determines whether transitions are enabled. |
| ValidateSourceNames | Validates source names in the timeline. |
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