Platform SDK: DirectX

DMUS_TRACKF_FLAGS

The DMUS_TRACKF_FLAGS values are used in the dwFlags parameter of the IDirectMusicTrack::Play method.

typedef enum enumDMUS_TRACKF_FLAGS {
    DMUS_TRACKF_SEEK   = 1,
    DMUS_TRACKF_LOOP   = 2,
    DMUS_TRACKF_START  = 4,
    DMUS_TRACKF_FLUSH  = 8,
    DMUS_TRACKF_DIRTY  = 16
} DMUS_TRACKF_FLAGS;
DMUS_TRACKF_SEEK
IDirectMusicTrack::Play was called in response to seeking, meaning that the mtStart parameter is not necessarily the same as the mtEnd of the previous call.
DMUS_TRACKF_LOOP
Play was called in response to a loop.
DMUS_TRACKF_START
This is the first call to IDirectMusicTrack::Play. DMUS_TRACKF_SEEK can also be set if the track is not playing from the beginning.
DMUS_TRACKF_FLUSH
Play was called in response to a flush or invalidation that requires the track to replay something that it played previously. In this case, DMUS_TRACKF_SEEK is set, as well.
DMUS_TRACKF_DIRTY
A control segment has begun or ended. Tracks that normally wait until mtNext to call IDirectMusicTrack::GetParam should make the call right away, instead of waiting, because their data might now be invalid. For more information on setting control segments, see DMUS_SEGF_FLAGS.

Remarks

When Play is called in response to a repeat, DMUS_TRACKF_LOOP and DMUS_TRACKF_SEEK are set.

Tracks must support seeking to support invalidation.

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.