midiInOpen

midiInOpen 関数は指定された MIDI 入力デバイスをオープンする。

midiInOpen phmi, uDeviceID, dwCallback, dwInstance, fdwOpen

phmi : [intptr] HMIDIIN ハンドルへのポインタ。この場所にオープンされた MIDI 入力デバイスを識別するハンドルが格納される。このハンドルは他の MIDI 入力関数の呼び出しでデバイスを識別するために使用される。
uDeviceID : [int] オープン対象の MIDI 入力デバイスの識別子。
dwCallback : [int] コールバック関数へのポインタ、スレッド識別子、または受信した MIDI メッセージに関する情報とともに呼び出されるウィンドウのハンドル。コールバック関数の詳細は MidiInProc を参照。
dwInstance : [int] コールバック関数へ渡されるユーザインスタンスデータ。このパラメータはウィンドウコールバック関数やスレッドでは使用されない。
fdwOpen : [int] デバイスを開くためのコールバックフラグ、およびオプションで高速データ転送を制御するためのステータスフラグ。次の値を指定できる。

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

解説

midiInOpen 関数は指定された MIDI 入力デバイスをオープンする。

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

[備考]
システムに存在する MIDI 入力デバイスの数を判定するには midiInGetNumDevs 関数を使用する。wDeviceID
で指定されるデバイス識別子は 0 から存在するデバイスの数より 1
少ない値までの範囲となる。コールバック情報の受け取り先としてウィンドウまたはスレッドが選択された場合、MIDI
入力の進捗を示すために次のメッセージがウィンドウプロシージャまたはスレッドへ送信される:
MM_MIM_OPEN、MM_MIM_CLOSE、MM_MIM_DATA、MM_MIM_LONGDATA、MM_MIM_ERROR、MM_MIM_LONGERROR、MM_MIM_MOREDATA。コールバック情報の受け取り先として関数が選択された場合、MIDI
入力の進捗を示すために次のメッセージが関数へ送信される:
MIM_OPEN、MIM_CLOSE、MIM_DATA、MIM_LONGDATA、MIM_ERROR、MIM_LONGERROR、MIM_MOREDATA。

情報