waveInUnprepareHeader

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

waveInUnprepareHeader hwi, pwh, cbwh

hwi : [intptr] 波形オーディオ入力デバイスへのハンドル。
pwh : [var] 後始末対象のバッファを識別する WAVEHDR 構造体へのポインタ。
cbwh : [int] WAVEHDR 構造体のサイズ (バイト単位)。

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

解説

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

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

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

情報