IAMTimelineGroup interface


[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.


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


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.




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



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.



Requirement Value