Microsoft DirectX 8.0 (C++) |
提供されるコード、サブコード レベル、および演奏モードを使って、MIDI ノートの値を DirectMusic ミュージック値に変換する。
HRESULT MIDIToMusic( BYTE bMIDIValue, DMUS_CHORD_KEY* pChord, BYTE bPlayMode, BYTE bChordLevel, WORD *pwMusicValue );
成功した場合は、次のいずれかの値を返す。「注意」を参照すること。
S_OK |
DMUS_S_DOWN_OCTAVE |
DMUS_S_UP_OCTAVE |
失敗した場合は、次のいずれかのエラー値を返す。
DMUS_E_CANNOT_CONVERT |
E_INVALIDARG |
メソッドが失敗した場合、*pwMusicValue は変更されない。
戻り値が DMUS_S_UP_OCTAVE または DMUS_DOWN_OCTAVE の場合、ノート変換では 0 未満または 128 以上のノートの値が生成されるため、0 〜 127 の適切な MIDI 範囲に収まるように、1 または複数オクターブ分だけ上または下に移動される。これは、演奏モード DMUS_PLAYMODE_FIXEDTOCHORD および DMUS_PLAYMODE_FIXEDTOKEY を使うときに発生することがある。どちらも、MIDI 値を *pwMusicValue に返す。
ヘッダー : dmusici.h で宣言。