Platform SDK: DirectX

DirectMusicPerformance.Invalidate

The DirectMusicPerformance.Invalidate method flushes all queued messages whose time stamps are later than the supplied time and causes all tracks of all segments to resend their data from the given time forward.

object.Invalidate(mtTime As Long, flags As Long)

Parameters

object
Object expression that resolves to a DirectMusicPerformance object.
mtTime
Time from which to invalidate, adjusted by flags. Setting this value to 0 causes immediate invalidation.
flags
Adjusts mtTime to align to measures, beats, or grids. This value can be 0 or one of the following members of CONST_DMUS_SEGF_FLAGS:

DMUS_SEGF_MEASURE
DMUS_SEGF_BEAT
DMUS_SEGF_GRID

Error Codes

If the method fails, it raises an error, and Err.Number can be set to DMUS_E_NO_MASTER_CLOCK.

Remarks

If mtTime is so long ago that it is impossible to invalidate that time, the earliest possible time is used.

See Also

DirectMusicPerformance.GetQueueTime