waveInAddBuffer 関数 (mmeapi.h)

waveInAddBuffer 関数は、指定された波形オーディオ入力デバイスに入力バッファーを送信します。バッファーがいっぱいになると、アプリケーションに通知されます。

構文

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

hwi

波形オーディオ入力デバイスに取り扱います。

pwh

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

cbwh

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

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

リターンコード	説明
MMSYSERR_INVALHANDLE	指定されたデバイスハンドルが無効です。
MMSYSERR_NODRIVER	デバイスドライバーが存在しません。
MMSYSERR_NOMEM	メモリを割り当てまたはロックできません。
WAVERR_UNPREPARED	pwh パラメーターが指すバッファーは準備されていません。

バッファーがいっぱいになると、WHDR_DONE ビットは WAVEHDR 構造体の dwFlags メンバーに設定されます。

バッファーは、この関数に渡される前に 、waveInPrepareHeader 関数を使用して準備する必要があります。

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