midiOutUnprepareHeader

midiOutUnprepareHeader 関数は midiOutPrepareHeader 関数で行った準備の後始末を行う。

midiOutUnprepareHeader hmo, pmh, cbmh

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

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

解説

midiOutUnprepareHeader 関数は midiOutPrepareHeader 関数で行った準備の後始末を行う。

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

[備考]
本関数は midiOutPrepareHeader 関数と対をなす。バッファを解放する前に midiOutUnprepareHeader
を呼び出さなければならない。midiOutLongMsg
関数でデバイスドライバへバッファを渡した後は、デバイスドライバがバッファの使用を終えるまで待ってから
midiOutUnprepareHeader を呼び出す必要がある。準備されていないバッファに対する後始末は効果がなく、関数は
MMSYSERR_NOERROR を返す。

情報