DMUS_CHORD_KEY
The DMUS_CHORD_KEY structure is used to describe a chord in the IDirectMusicPerformance8::MIDIToMusic and IDirectMusicPerformance8::MusicToMIDI methods.
Syntax
typedef struct _DMUS_CHORD_KEY {
WCHAR wszName[16];
WORD wMeasure;
BYTE bBeat;
BYTE bSubChordCount;
DMUS_SUBCHORD SubChordList[DMUS_MAXSUBCHORD];
DWORD dwScale;
BYTE bKey;
BYTE bFlags;
} DMUS_CHORD_KEY;
Members
wszName
Name of the chord as specified in the Chordmap Designer component of DirectMusic Producer; for example, 2CM.
wMeasure
Measure that the chord falls on.
bBeat
Beat that the chord falls on.
bSubChordCount
Number of chords in the chord's list of subchords.
SubChordList
Array of DMUS_SUBCHORD structures, describing the components that make up the chord.
dwScale
Scale underlying the entire chord. Each of the lower 24 bits represents a note in a two-octave scale, where position 0 is the root note of the scale.
bKey
Key underlying the entire chord, where 0 is C, 1 is C# or Bb, and so on.
bFlags
Can be zero, or DMUS_CHORDKEYF_SILENT if the chord is silent. See Remarks.
Remarks
This structure is also defined as a DMUS_CHORD_PARAM structure for use in setting and retrieving the GUID_ChordParam track parameter.
If a chord is flagged as a silent chord, it is not taken into consideration when a pattern is selected to be played. For instance, if there is a chord change on beat 1 and the silent chord is on beat 3, a pattern with a whole measure chord rhythm can still be played.
Requirements
** Header:** Dmusici.h
See Also