DMUS_CHORD_KEY

DirectMusic

previous page next page

Microsoft DirectX 9.0 SDK Update (Summer 2004)

^{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: Declared in dmusici.h.

See Also

previous page start next page