Microsoft DirectX 8.0 (C++) |
Converts a MIDI note value to a DirectMusic music value, using a supplied chord, subchord level, and play mode.
HRESULT MIDIToMusic( BYTE bMIDIValue, DMUS_CHORD_KEY* pChord, BYTE bPlayMode, BYTE bChordLevel, WORD *pwMusicValue );
If the method succeeds, the return value is one of the following. See Remarks.
S_OK |
DMUS_S_DOWN_OCTAVE |
DMUS_S_UP_OCTAVE |
If it fails, the method can return one of the following error values:
DMUS_E_CANNOT_CONVERT |
E_INVALIDARG |
If the method fails, *pwMusicValue is not changed.
If the return value is DMUS_S_UP_OCTAVE or DMUS_DOWN_OCTAVE, the note conversion generated a note value that is less than 0 or greater than 127, so it has been bumped up or down one or more octaves to be in the proper MIDI range of from 0 through 127. This can occur when using play modes DMUS_PLAYMODE_FIXEDTOCHORD and DMUS_PLAYMODE_FIXEDTOKEY, both of which return MIDI values in *pwMusicValue.
Header: Declared in dmusici.h.
IDirectMusicPerformance8::MusicToMIDI, Music Values and MIDI Notes