DMUS_NOTE_PMSG
The DMUS_NOTE_PMSG structure contains data for a music-note event.
typedef struct DMUS_NOTE_PMSG {
DMUS_PMSG_PART
MUSIC_TIME mtDuration;
WORD wMusicValue;
WORD wMeasure;
short nOffset;
BYTE bBeat;
BYTE bGrid;
BYTE bVelocity;
BYTE bFlags;
BYTE bTimeRange;
BYTE bDurRange;
BYTE bVelRange;
BYTE bPlayModeFlags;
BYTE bSubChordLevel;
BYTE bMidiValue;
} DMUS_NOTE_PMSG;
- DMUS_PMSG_PART
- Macro for common message members. See DMUS_PMSG.
- mtDuration
- Duration of the note.
- wMusicValue
- Description of the note. In most play modes, this is a packed array of 4-bit values, as follows:
- Octave
- In the range from –2 through 14. The note is transposed up or down by the octave times 12.
- Chord position
- In the range from 0 through 15, although it should never be above 3. The first position in the chord is 0.
- Scale position
- In the range from 0 through 15. Typically it is only from 0 through 2, but it is possible to have a one-note chord and have everything above the chord be interpreted as a scale position.
- Accidental
- In the range from –8 through 7, but typically in the range from –2 through 2. This represents an offset that takes the note out of the scale.
In the fixed-play modes, the music value is a MIDI note value in the range from 0 through 127.
- wMeasure
- Measure in which this note occurs.
- nOffset
- Offset from the at which this note occurs, in music time.
- bBeat
- Beat (in measure) at which this note occurs.
- bGrid
- Grid offset from the beat at which this note occurs.
- bVelocity
- Note .
- bFlags
- See DMUS_NOTEF_FLAGS.
- bTimeRange
- Range by which to randomize time.
- bDurRange
- Range by which to randomize duration.
- bVelRange
- Range by which to randomize velocity.
- bPlayModeFlags
- Play mode determining how the music value is related to the chord and subchord. For a list of values, see DMUS_PLAYMODE_FLAGS.
- bSubChordLevel
- Subchord level that the note uses. See DMUS_SUBCHORD.
- bMidiValue
- MIDI note value, converted from wMusicValue.
Remarks
When a note is to be played, the DMUS_NOTE_PMSG flows through the graph and any tools in the graph until it reaches the final MIDI output tool. When the tool recognizes that DMUS_NOTEF_NOTEON is set in the bFlags member, it sends a MIDI note-on message to the correct port (according to the dwPChannel member of the DMUS_PMSG part). It then clears the flag, adds mtDuration to the time stamp, and requeues the message so that the note is turned off at the appropriate time.
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
IDirectMusicPerformance::SendPMsg, Music Values and MIDI Notes