IAMTimelineGroup 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 IAMTimelineGroup interface sets and retrieves properties on groups in DirectShow Editing Services (DES).
A group contains one or more tracks, and possibly one or more compositions, which in turn contain source clips of a uniform type, such as video or audio. Groups are the topmost compositions in a timeline, and also expose the IAMTimelineComp interface. A timeline can contain multiple groups.
Each group has the following attributes.
- An associated media type.
- The frame rate at which the group renders, in frames per second (FPS). All edits occur at a time rounded to the nearest frame boundary, as defined by the group's FPS setting.
- A priority level, for writing files with multiple streams of the same media type (for example, a two-video-stream AVI file).
To create a group object, call IAMTimeline::CreateEmptyNode with the value TIMELINE_MAJOR_TYPE_GROUP. You can query the returned IAMTimelineObj pointer for the IAMTimelineGroup interface.
Members
The IAMTimelineGroup interface inherits from the IUnknown interface. IAMTimelineGroup also has these types of members:
Methods
The IAMTimelineGroup interface has these methods.
| Method | Description |
|---|---|
| ClearRecompressFormatDirty | Not supported. |
| GetGroupName | Retrieves the application-defined name of the group. |
| GetMediaType | Retrieves the uncompressed media type for the group. |
| GetOutputBuffering | Retrieves the number of frames rendered in advance during preview. |
| GetOutputFPS | Retrieves the output frame rate of this group. |
| GetPreviewMode | Retrieves the preview mode for the group. |
| GetPriority | Retrieves the group's priority. |
| GetSmartRecompressFormat | Retrieves the current compression format for smart recompression. |
| GetTimeline | Retrieves the timeline to which this group belongs. |
| IsRecompressFormatDirty | Not supported. |
| IsSmartRecompressFormatSet | Determines whether a smart compression format was set for the group. |
| SetGroupName | Sets the application-defined name of the group. |
| SetMediaType | Sets the uncompressed media type for the group. |
| SetMediaTypeForVB | Specifies the group media type, for Automation clients. |
| SetOutputBuffering | Specifies the number of frames rendered in advance during preview. |
| SetOutputFPS | Sets the uncompressed output frame rate for this group. |
| SetPreviewMode | Sets the preview mode for the group. |
| SetRecompFormatFromSource | Sets the video recompression format using the compression format from a source file. |
| SetSmartRecompressFormat | Specifies a compression format to use for smart recompression. |
| SetTimeline | Not supported. |
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