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