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成員中設定。

緩衝區必須先備妥 waveOutPrepareHeader 函 式，才能傳遞至 waveOutWrite。 除非呼叫 waveOutPause 函式暫停裝置，否則當第一個資料區區塊轉送至裝置時，就會開始播放。

需求

最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	mmeapi.h (包含 Windows.h)
程式庫	Winmm.lib
Dll	Winmm.dll

另請參閱

電壓音訊

電壓函數