waveOutPrepareHeader 函数 (mmeapi.h)
waveOutPrepareHeader 函数准备用于播放的波形音频数据块。
语法
MMRESULT waveOutPrepareHeader(
HWAVEOUT hwo,
LPWAVEHDR pwh,
UINT cbwh
);
parameters
hwo
波形音频输出设备的句柄。
pwh
指向 WAVEHDR 结构的指针,该结构标识要准备的数据块。
cbwh
WAVEHDR 结构的大小(以字节为单位)。
返回值
如果成功 , 则返回MMSYSERR_NOERROR,否则返回错误。 可能的错误值包括以下内容。
返回代码 | 说明 |
---|---|
|
指定的设备句柄无效。 |
|
不存在设备驱动程序。 |
|
无法分配或锁定内存。 |
注解
在调用此函数之前,设置 WAVEHDR 结构的 lpData、dwBufferLength 和 dwFlags 成员。 将 dwFlags 成员设置为零。
WAVEHDR 结构的 dwFlags、dwBufferLength 和 dwLoops 成员可以在调用此函数和 waveOutWrite 函数之间更改。 如果在调用 waveOutWrite 之前更改 dwBufferLength 指定的大小,则新值必须小于准备好的值。
如果该方法成功,则会在 WAVEHDR 结构的 dwFlags 成员中设置WHDR_PREPARED标志。
准备已准备好的标头不起作用,函数返回零。
要求
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | mmeapi.h (包括 Mmeapi.h、Windows.h) |
Library | Winmm.lib |
DLL | Winmm.dll |