Microsoft DirectX 8.1 (C++)

IAMTimelineComp::VTrackInsBefore

The VTrackInsBefore method inserts a virtual track into the composition at the specified priority.

Syntax

HRESULT VTrackInsBefore(
    IAMTimelineObj *pVirtualTrack,
    long Priority
);

Parameters

pVirtualTrack

Pointer to the IAMTimelineObj interface of the virtual track.

Priority

Priority at which to insert the virtual track, or –1 to insert the virtual track at the end of the priority list.

Return Value

Returns one of the following HRESULT values:

Return code Description
S_OK Success.
E_INVALIDARG Invalid argument.
E_NOINTERFACE Object is not a virtual track.

Remarks

Priority levels start at zero. If the timeline already contains a virtual track at the specified priority level, everything from that point on moves down the priority list to make room for the inserted track. This method fails if the specified priority is greater than the current number of tracks.

See Also