Microsoft DirectX 8.1 (C++)

IAMTimelineObj::SetStartStop

The SetStartStop method sets the object's start and stop times, relative to the object's parent.

Syntax

HRESULT SetStartStop(
    REFERENCE_TIME Start,
    REFERENCE_TIME Stop
);

Parameters

Start

New start time, in 100-nanosecond units, or –1 to keep the existing start time.

Stop

New stop time, in 100-nanosecond units, or –1 to keep the existing stop time.

Return Value

Returns one of the following HRESULT values:

Return code Description
S_OK Success.
E_INVALIDARG Invalid argument.
E_NOTIMPL Not implemented.

Remarks

Tracks, compositions, and groups do not implement this method. For these objects, the start time is always zero, and the stop time is the maximum stop time of the objects they contain.

Do not set overlapping times on source objects within the same track. Doing so can cause undefined behaviors.

For source objects, the start and stop times are independent of the media start and media stop times. Changing one pair of values does not change the other. To set the media start and stop times, call the IAMTimelineSrc::SetMediaTimes method. For more information, see Time in DirectShow Editing Services.

See Also