Microsoft DirectX 8.0 (C++)

DMUS_CHORD_KEY

Used to describe a chord in the IDirectMusicPerformance8::MIDIToMusic and IDirectMusicPerformance8::MusicToMIDI methods.

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.
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.
bKey
Key underlying the entire chord.
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: Declared in dmusici.h.

See Also

IDirectMusicPerformance8::GetParam, IDirectMusicPerformance8::SetParam, IDirectMusicSegment8::GetParam, IDirectMusicSegment8::SetParam, IDirectMusicTrack8::GetParamEx, IDirectMusicTrack8::SetParamEx, Performance Parameters