midiInPrepareHeader

midiInPrepareHeader 関数は MIDI 入力用のバッファを準備する。

midiInPrepareHeader hmi, pmh, cbmh

hmi : [intptr] MIDI 入力デバイスへのハンドル。デバイスハンドルを取得するには midiInOpen を呼び出す。
pmh : [var] 準備対象のバッファを識別する MIDIHDR 構造体へのポインタ。
cbmh : [int] MIDIHDR 構造体のサイズ (バイト単位)。

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

解説

midiInPrepareHeader 関数は MIDI 入力用のバッファを準備する。

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

[備考]
MIDI データブロックをデバイスドライバへ渡す前に、midiInPrepareHeader
関数へ渡すことでバッファを準備する必要がある。ヘッダが準備された後はバッファを変更してはならない。ドライバがバッファの使用を終えた後は
midiInUnprepareHeader
関数を呼び出す。アプリケーションは同じバッファを再利用するか、複数のバッファを割り当てそれぞれに対し
midiInPrepareHeader を呼び出すことができる。同じバッファを再利用する場合は毎回バッファを準備する必要はない。最初に
midiInPrepareHeader を 1 回呼び出し、最後に midiInUnprepareHeader を 1
回呼び出すだけでよい。既に準備済みのヘッダを準備しても効果はなく、関数は 0 を返す。

情報