waveOutClose 函数关闭给定的波形音频输出设备。
语法
MMRESULT waveOutClose(
HWAVEOUT hwo
);
参数
hwo
波形音频输出设备的句柄。 如果函数成功,则此调用后句柄不再有效。
返回值
如果成功,则返回MMSYSERR_NOERROR,否则返回错误。 可能的错误值包括以下内容。
| 返回代码 | 说明 |
|---|---|
|
指定的设备句柄无效。 |
|
不存在设备驱动程序。 |
|
无法分配或锁定内存。 |
|
队列中仍有缓冲区。 |
注解
如果设备仍在播放以前通过调用 waveOutWrite 发送的波形音频缓冲区,关闭操作将失败。 在调用 waveOutClose 之前,应用程序必须等待所有缓冲区完成播放或调用 waveOutReset 函数以终止播放。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | mmeapi.h (包括 Windows.h) |
| Library | Winmm.lib |
| DLL | Winmm.dll |