Microsoft DirectX 8.1 (C++)

IAMTimelineTransable::GetTransAtTime

The GetTransAtTime method retrieves the transition nearest to the specified time, according to the specified boundary conditions.

Syntax

HRESULT GetTransAtTime(
    IAMTimelineObj **ppObj, 
    REFERENCE_TIME Time, 
    long SearchDirection
);

Parameters

ppObj

[out] Address of a pointer to receive the transition's IAMTimelineObj interface.

Time

Time from which to begin 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 No transition was found.
S_OK Transition was found.
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