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

Time from which to invalidate, adjusted by dwFlags. Setting this value to 0 causes immediate invalidation.

dwFlags

Flags that adjust 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 can 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 is used.

Requirements

  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