midiInStart

midiInStart 関数は指定された MIDI 入力デバイスで MIDI 入力を開始する。

midiInStart hmi

hmi : [intptr] MIDI 入力デバイスへのハンドル。

(プラグイン / モジュール : winmm.dll)

解説

midiInStart 関数は指定された MIDI 入力デバイスで MIDI 入力を開始する。

[戻り値]
成功時は MMSYSERR_NOERROR を、それ以外の場合はエラーを返す。考えられるエラー値は次のとおり。
（以下省略）

[備考]
本関数はタイムスタンプを 0
にリセットする。以降に受信したメッセージのタイムスタンプ値は本関数が呼び出された時刻からの相対値となる。システムエクスクルーシブメッセージ以外の全てのメッセージは受信されたときに直接クライアントへ送信される。システムエクスクルーシブメッセージは
midiInAddBuffer
関数で供給されたバッファに格納される。キューにバッファがない場合、システムエクスクルーシブデータはクライアントへ通知されることなく破棄され、入力は続行される。バッファは満杯になったとき、完全なシステムエクスクルーシブメッセージを受信したとき、または
midiInReset 関数が使用されたときにクライアントへ返される。MIDIHDR 構造体の dwBytesRecorded
メンバには受信したデータの実際の長さが格納される。入力が既に開始されている状態で本関数を呼び出しても効果はなく、関数は 0 を返す。

情報