^{DMUS_NOTEF_FLAGS}

The DMUS_NOTEF_FLAGS enumerated type is used in the bFlags member of the DMUS_NOTE_PMSG structure.

Syntax

typedef enum enumDMUS_NOTEF_FLAGS {
  DMUS_NOTEF_NOTEON               =    1,
  DMUS_NOTEF_NOINVALIDATE         =    2,
  DMUS_NOTEF_NOINVALIDATE_INSCALE =    4,
  DMUS_NOTEF_NOINVALIDATE_INCHORD =    8,
  DMUS_NOTEF_REGENERATE           = 0x10,
} DMUS_NOTEF_FLAGS;

Constants

DMUS_NOTEF_NOTEON

MIDI note-on. When a DMUS_NOTE_PMSG is first sent by the IDirectMusicPerformance8::SendPMsg method, this flag should be set. If the flag is not set, the message is a note-off.

DMUS_NOTEF_NOINVALIDATE

Do not invalidate the note.

DMUS_NOTEF_NOINVALIDATE_INSCALE

Do not invalidate if the note is still within the scale.

DMUS_NOTEF_NOINVALIDATE_INCHORD

Do not invalidate if the note is still within the chord.

DMUS_NOTEF_REGENERATE

Regenerate the note when a chord change occurs. The note's music value, subchord level, and play mode flags are used to construct a new note according to the new chord and scale. If the original note had a timing offset, this is applied to the start time of the new note.

Remarks

The NOINVALIDATE flags ensure that the note plays for its full duration even when messages are invalidated.

Requirements

  Header: Declared in dmusici.h.

See Also

• DirectMusic Enumerated Types