Microsoft DirectX 8.0 (C++)

DMUS_TRANSPOSE_PMSG

Contains message data for a transposition.

typedef struct _DMUS_TRANSPOSE_PMSG {
    DMUS_PMSG_PART
    short nTranspose;
    WORD wMergeIndex;
} DMUS_TRANSPOSE_PMSG;
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

IDirectMusicPerformance8::SendPMsg