Share via

IAMTimelineTransable::GetNextTrans

  • Article
 
Microsoft DirectShow 9.0

IAMTimelineTransable::GetNextTrans

The GetNextTrans method retrieves the first transition that appears at the specified time or later.

Syntax

  HRESULT GetNextTrans(
    IAMTimelineObj **ppTrans,
    REFERENCE_TIME *pInOut
);

Parameters

ppTrans

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

pInOut

Pointer to a variable that specifies the time in 100-nanosecond units. On input, this value specifies the time from which to find the transition. On output, if a transition is retrieved, this value is set to the stop time of the transition.

Return Value

Returns S_OK if the method retrieves a transition, or S_FALSE if it does not find a transition. Otherwise, returns an HRESULT value indicating the cause of the failure.

Remarks

The start time of the transition might be less than the time that you specify in pInOut, if the transition spans the specified time.

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.

Requirements

Header: Include Qedit.h. This header file is not compatible with Microsoft® Direct3D® headers later than version 7.

Library: Use strmiids.lib.

See Also