Microsoft DirectX 8.1 (C++)

IAMTimelineTrack::GetSrcAtTime

The GetSrcAtTime method retrieves the source object nearest to the specified time, according to the specified boundary conditions.

Syntax

HRESULT GetSrcAtTime(
    IAMTimelineObj **ppSrc,
    REFERENCE_TIME Time,
    long SearchDirection
);

Parameters

ppSrc

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

Time

Start time for the search, in 100-nanosecond units.

SearchDirection

Member of the DEXTERF_TRACK_SEARCH_FLAGS enumerated type that specifies the boundary conditions for the search.

Return Value

Returns one of the following HRESULT values:

Value Description
S_FALSE Did not locate a source object.
S_OK Located a source object.
E_INVALIDARG Invalid argument.
E_POINTER NULL pointer argument.

Remarks

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