midiInUnprepareHeader

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

midiInUnprepareHeader hmi, pmh, cbmh

hmi : [intptr] MIDI 入力デバイスへのハンドル。
pmh : [var] 後始末対象のバッファを識別する MIDIHDR 構造体へのポインタ。
cbmh : [int] MIDIHDR 構造体のサイズ。

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

解説

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

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

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

情報