waveOutWrite 函式 (mmeapi.h)
waveOutWrite函式會將資料區區塊轉送至指定的電壓音訊輸出裝置。
語法
MMRESULT waveOutWrite(
HWAVEOUT hwo,
LPWAVEHDR pwh,
UINT cbwh
);
參數
hwo
處理電壓音訊輸出裝置。
pwh
WAVEHDR結構的指標，其中包含資料區塊的相關資訊。
cbwh
WAVEHDR結構的大小，以位元組為單位。
傳回值
如果成功或發生錯誤，則傳回MMSYSERR_NOERROR。 可能的錯誤值包括下列專案。
| 傳回碼 | 描述 |
|---|---|
|
指定的裝置控制碼無效。 |
|
沒有設備磁碟機。 |
|
無法配置或鎖定記憶體。 |
|
pwh 參數所指向的資料區塊尚未備妥。 |
備註
當緩衝區完成時，WHDR_DONE位會在WAVEHDR結構的dwFlags成員中設定。
緩衝區必須先備妥 waveOutPrepareHeader 函 式，才能傳遞至 waveOutWrite。 除非呼叫 waveOutPause 函式暫停裝置，否則當第一個資料區區塊轉送至裝置時，就會開始播放。
需求
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | mmeapi.h (包含 Windows.h) |
| 程式庫 | Winmm.lib |
| Dll | Winmm.dll |