IAMTimelineSrc 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 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.
Members
The IAMTimelineSrc interface inherits from the IUnknown interface. IAMTimelineSrc also has these types of members:
Methods
The IAMTimelineSrc interface has these methods.
| Method | Description |
|---|---|
| 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. |
| GetDefaultFPS | Retrieves the source object's default frame rate. |
| GetMediaLength | Retrieves the media length of this source object. |
| GetMediaLength2 | Retrieves the media length of this source object, as a REFTIME value. |
| 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. |
| GetStreamNumber | Retrieves the current stream number for the source object. |
| GetStretchMode | Retrieves the stretch mode of a video source. |
| 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. |
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