IDirectMusicPerformance::Invalidate

The IDirectMusicPerformance::Invalidate method flushes all queued messages from the supplied time forward, and causes all tracks of all segments to resend their data from the given time forward.

HRESULT Invalidate(
  MUSIC_TIME mtTime, 
  DWORD dwFlags
);
 

Parameters

mtTime
The time from which to invalidate, adjusted by dwFlags. Setting this value to 0 causes immediate invalidation.
dwFlags
Adjusts mtTime to align to measures, beats, or grids. This value can be 0 or one of the following members of the DMUS_SEGF_FLAGS enumeration:

DMUS_SEGF_MEASURE
DMUS_SEGF_BEAT
DMUS_SEGF_GRID

Return Values

If the method succeeds, the return value is S_OK.

If it fails, the method may return DMUS_E_NO_MASTER_CLOCK.

Remarks

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

QuickInfo

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dmusici.h.

See Also

Prepare Time, Segment Timing