waveInUnprepareHeader 関数 (mmeapi.h)

  • [アーティクル]

waveInUnprepareHeader 関数は、waveInPrepareHeader 関数によって実行される準備をクリーンアップします。 この関数は、デバイス ドライバーがバッファーを入力してアプリケーションに返した後に呼び出す必要があります。 バッファーを解放する前に、この関数を呼び出す必要があります。

構文

MMRESULT waveInUnprepareHeader(
  HWAVEIN   hwi,
  LPWAVEHDR pwh,
  UINT      cbwh
);

パラメーター

hwi

波形オーディオ入力デバイスへの取り扱い。

pwh

クリーンアップするバッファーを識別する WAVEHDR 構造体へのポインター。

cbwh

WAVEHDR 構造体のサイズ (バイト単位)。

戻り値

成功した場合はMMSYSERR_NOERRORを返し、それ以外の場合はエラーを返します。 考えられるエラー値は次のとおりです。

リターン コード 説明
MMSYSERR_INVALHANDLE
 指定されたデバイス ハンドルが無効です。
MMSYSERR_NODRIVER
 デバイス ドライバーが存在しません。
MMSYSERR_NOMEM
 メモリを割り当てまたはロックできません。
WAVERR_STILLPLAYING
 pwh パラメーターによって指されるバッファーは、まだキュー内にあります。

注釈

この関数は、 waveInPrepareHeader 関数を 補完します。

バッファーを解放する前に、この関数を呼び出す必要があります。 waveInAddBuffer 関数を使用してデバイス ドライバーにバッファーを渡した後、ドライバーがバッファーで終了するまで待ってから、waveInUnprepareHeader を呼び出す必要があります。 準備されていないバッファーの準備を解除しても効果はなく、関数は 0 を返します。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー mmeapi.h (Windows.h を含む)
Library Winmm.lib
[DLL] Winmm.dll

こちらもご覧ください

波形オーディオ

波形関数