waveOutWrite 関数 (mmeapi.h)

  • [アーティクル]

waveOutWrite 関数は、指定された波形オーディオ出力デバイスにデータ ブロックを送信します。

構文

MMRESULT waveOutWrite(
  HWAVEOUT  hwo,
  LPWAVEHDR pwh,
  UINT      cbwh
);

パラメーター

hwo

波形オーディオ出力デバイスへのハンドル。

pwh

データ ブロックに関する情報を含む WAVEHDR 構造体へのポインター。

cbwh

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

戻り値

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

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

解説

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

バッファーを waveOutWrite に渡す前に、waveOutPrepareHeader 関数を使用してバッファーを準備する必要があります。 waveOutPause 関数を呼び出してデバイスを一時停止しない限り、最初のデータ ブロックがデバイスに送信されると再生が開始されます。

要件

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

関連項目

波形オーディオ

波形関数