Microsoft DirectX 9.0

IAMTimelineEffectable.EffectInsBefore Method

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


    pFX As AMTimelineObj,
    Priority As Long



The AMTimelineObj object that specifies the effect.


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.


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