IDirectMusicComposer::ChangeChordMap

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

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

Parameters

pSectionSeg

Segment in which to change the chordmap.

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

The new chordmap for the segment.

Return Values

If the method succeeds, the return value is S_OK.

If it fails, the method may return E_POINTER.

Remarks

The method can be called while the segment is playing.

QuickInfo

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dmusici.h.