IAMTimelineSrc Interface
| Microsoft DirectShow 9.0 |
IAMTimelineSrc Interface
The IAMTimelineSrc interface provides methods for manipulating and setting properties on source objects in DirectShow Editing Services (DES). A source object represents one stream from a media source.
You can use a portion of the data within a source file by setting the media start and media stop times. These values specify the beginning and end of the source object, relative to the original media source. The media times can differ from the object's start and stop times on the timeline , allowing for fast- or slow-motion playback. (With audio sources, pitch shifting occurs.)
To create a source object, call IAMTimeline::CreateEmptyNode with the value TIMELINE_MAJOR_TYPE_SOURCE. You can query the returned IAMTimelineObj pointer for the IAMTimelineSrc interface. For more information, see Constructing a Timeline and Working with Sources.
In addition to the methods inherited from IUnknown, the IAMTimelineSrc interface exposes the following methods.
| Method | Description |
| GetDefaultFPS | Retrieves the source object's default frame rate. |
| GetMediaName | Retrieves the name of the source file represented by this source object. |
| GetMediaTimes | Retrieves the media start and stop times. |
| GetMediaTimes2 | Retrieves the media start and stop times, as REFTIME values. |
| GetMediaLength | Retrieves the media length of this source object. |
| GetMediaLength2 | Retrieves the media length of this source object, as a REFTIME value. |
| GetStreamNumber | Retrieves the current stream number for the source object. |
| GetStretchMode | Retrieves the stretch mode of a video source. |
| FixMediaTimes | Rounds the specified time values to the nearest frame boundary. |
| FixMediaTimes2 | Rounds the specified time values, given as REFTIME values, to the nearest frame boundary. |
| IsNormalRate | Indicates whether the clip will play at the normal playback rate. |
| ModifyStopTime | Sets the stop time, relative to the timeline. |
| ModifyStopTime2 | Sets the stop time, as a REFTIME value. |
| SetDefaultFPS | Sets the source object's default frame rate. |
| SetMediaLength | Specifies the duration of the source file. |
| SetMediaLength2 | Specifies the duration of the source file, as a REFTIME value. |
| SetMediaName | Specifies the name of the source file represented by this source object. |
| SetMediaTimes | Sets the media stop and start times. |
| SetMediaTimes2 | Sets the media stop and start times, as REFTIME values. |
| SetStreamNumber | Specifies which stream to read from the source file associated with this source object. |
| SetStretchMode | Sets the stretch mode of a video source. |
| SpliceWithNext | Joins this source object to another source object. |
Requirements
Header: Include Qedit.h. This header file is not compatible with Microsoft® Direct3D® headers later than version 7.
Library: Use strmiids.lib.