IDirectMusicComposer8::ChangeChordMap

The ChangeChordMap method modifies the chords and scale pattern of an existing segment to reflect a new chordmap.

Syntax

HRESULT ChangeChordMap(
  IDirectMusicSegment* pSegment, 
  BOOL fTrackScale, 
  IDirectMusicChordMap* pChordMap
);

Parameters

pSegment

Pointer to the IDirectMusicSegment8 interface of the segment in which to change the chordmap. This segment must contain a chordmap track and a style.

fTrackScale

If TRUE, the method transposes all the chords to be relative to the root of the new chordmap's scale, rather than leaving their roots as they were.

pChordMap

Pointer to the IDirectMusicChordMap8 interface of the new chordmap for the segment.

Return Values

If the method succeeds, the return value is S_OK.

If it fails, the method can return E_POINTER.

Remarks

The method can be called while the segment is playing.

Requirements

  Header: Dmusici.h
  Library: Dmcompos.dll, Dmcompod.dll

See Also

• IDirectMusicComposer8 Interface
• Using Chordmaps