Microsoft DirectX 8.1 (C++)

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.

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