midiOutPrepareHeader

midiOutPrepareHeader 関数は MIDI システムエクスクルーシブまたはストリームバッファを出力用に準備する。

midiOutPrepareHeader hmo, pmh, cbmh

hmo : [intptr] MIDI 出力デバイスへのハンドル。デバイスハンドルを取得するには midiOutOpen を呼び出す。HMIDIOUT 型にキャストされた MIDI ストリームのハンドルも指定できる。
pmh : [var] 準備対象のバッファを識別する MIDIHDR 構造体へのポインタ。
cbmh : [int] MIDIHDR 構造体のサイズ (バイト単位)。

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

解説

midiOutPrepareHeader 関数は MIDI システムエクスクルーシブまたはストリームバッファを出力用に準備する。

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

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

情報