Microsoft DirectX 8.1 (C++)

IAMTimelineTrack::GetNextSrc

The GetNextSrc method searches the track for the next source that appears at the specified time or later.

Syntax

HRESULT GetNextSrc(
    IAMTimelineObj **ppSrc,
    REFERENCE_TIME *pInOut
);

Parameters

ppSrc

[out] Address of a pointer that receives the source object's IAMTimelineObj interface.

pInOut

Pointer to a variable that contains the start time for the search, in 100-nanosecond units. If the method retrieves a source, it sets the value to the stop time of the source. If the method does not retrieve a source, the value becomes invalid and the application should not use it.

Return Value

Returns S_OK if the method retrieves a source, or S_FALSE otherwise.

Remarks

If the time specified by pInOut falls between the start and stop times of a source, the method retrieves that source.

If the method returns S_OK, the IAMTimelineObj interface that it returns has an outstanding reference count. Be sure to release the interface when you are finished using it.

See Also