waveOutUnprepareHeader 函数 (mmeapi.h)
waveOutUnprepareHeader 函数清理 waveOutPrepareHeader 函数执行的准备工作。 必须使用数据块完成设备驱动程序后调用此函数。 在释放缓冲区之前，必须调用此函数。
语法
MMRESULT waveOutUnprepareHeader(
HWAVEOUT hwo,
LPWAVEHDR pwh,
UINT cbwh
);
parameters
hwo
波形音频输出设备的句柄。
pwh
指向 WAVEHDR 结构的指针，该结构标识要清理的数据块。
cbwh
WAVEHDR 结构的大小（以字节为单位）。
返回值
如果成功，则返回MMSYSERR_NOERROR，否则返回错误。 可能的错误值包括以下内容。
| 返回代码 | 说明 |
|---|---|
|
指定的设备句柄无效。 |
|
不存在设备驱动程序。 |
|
无法分配或锁定内存。 |
|
pwh 参数指向的数据块仍在队列中。 |
注解
此函数补充 waveOutPrepareHeader。 在释放缓冲区之前，必须调用此函数。 使用 waveOutWrite 函数将缓冲区传递给设备驱动程序后，必须等待驱动程序完成缓冲区，然后再调用 waveOutUnprepareHeader。
取消准备尚未准备的缓冲区不起作用，函数返回零。
要求
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | mmeapi.h (包括 Windows.h) |
| Library | Winmm.lib |
| DLL | Winmm.dll |