Microsoft DirectX 9.0

DMUS_TRANSPOSE_PMSG

The DMUS_TRANSPOSE_PMSG structure contains message data for a transposition.

Syntax

typedef struct _DMUS_TRANSPOSE_PMSG {
  DMUS_PMSG_PART
  short nTranspose;
  WORD wMergeIndex;
} DMUS_TRANSPOSE_PMSG;

Members

DMUS_PMSG_PART

Macro for common message members. See DMUS_PMSG.

nTranspose

Number of semitones by which to transpose. This can be a negative value.

wMergeIndex

Merge index. When a transpose message follows a preceding message with the same wMergeIndex, the value in nTranspose becomes the new setting. When the second transpose message has a different wMergeIndex, the value in nTranspose is added to the previous setting. This member is significant only if DMUS_PMSGF_DX8 is present in the dwFlags member of the DMUS_PMSG part of this structure.

Remarks

If the transposition of a note puts it outside the standard MIDI range from 0 through 127, it does not play.

Requirements

  Header: Declared in dmusici.h.

See Also