waveOutWrite 函数 (mmeapi.h)
waveOutWrite 函数将数据块发送到给定的波形音频输出设备。
语法
MMRESULT waveOutWrite(
HWAVEOUT hwo,
LPWAVEHDR pwh,
UINT cbwh
);
parameters
hwo
波形音频输出设备的句柄。
pwh
指向包含数据块相关信息的 WAVEHDR 结构的指针。
cbwh
WAVEHDR 结构的大小（以字节为单位）。
返回值
如果成功，则返回MMSYSERR_NOERROR，否则返回错误。 可能的错误值包括以下内容。
| 返回代码 | 说明 |
|---|---|
|
指定的设备句柄无效。 |
|
不存在设备驱动程序。 |
|
无法分配或锁定内存。 |
|
pwh 参数指向的数据块尚未准备好。 |
注解
缓冲区完成后，在 WAVEHDR 结构的 dwFlags 成员中设置WHDR_DONE位。
缓冲区必须先使用 waveOutPrepareHeader 函数准备，然后才能将其传递给 waveOutWrite。 除非通过调用 waveOutPause 函数暂停设备，否则播放会在第一个数据块发送到设备时开始。
要求
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | mmeapi.h (包括 Windows.h) |
| Library | Winmm.lib |
| DLL | Winmm.dll |