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.
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.