Microsoft DirectX 8.1 (C++)

IAMTimelineEffectable.EffectInsBefore Method

The IAMTimelineEffectable.EffectInsBefore method inserts an effect into the object at the specified priority level.

Syntax

object.EffectInsBefore(
    pFX As AMTimelineObj,
    Priority As Long
)

Parameters

pFX

The AMTimelineObj object that specifies the effect.

Priority

Priority level at which to insert the effect. Use the value –1 to insert the effect at the end of the priority list.

Error Codes

If the method fails, an error is raised, and Err.Number can be set to the following value:

Value Description
E_NOTIMPL The object specified by pFX is not an effect.

Remarks

The start and stop times of the effect are clipped within the bounds of the object's time range, if necessary.

If there is already an effect at the specified priority level, all the effects from that point on move down the priority list to make room for the new effect.

See Also