waveOutPrepareHeader 函数 (mmeapi.h)

waveOutPrepareHeader 函数准备用于播放的波形音频数据块。

语法

MMRESULT waveOutPrepareHeader(
  HWAVEOUT  hwo,
  LPWAVEHDR pwh,
  UINT      cbwh
);

parameters

hwo

波形音频输出设备的句柄。

pwh

指向 WAVEHDR 结构的指针,该结构标识要准备的数据块。

cbwh

WAVEHDR 结构的大小(以字节为单位)。

返回值

如果成功 则返回MMSYSERR_NOERROR,否则返回错误。 可能的错误值包括以下内容。

返回代码 说明
MMSYSERR_INVALHANDLE
指定的设备句柄无效。
MMSYSERR_NODRIVER
不存在设备驱动程序。
MMSYSERR_NOMEM
无法分配或锁定内存。

注解

在调用此函数之前,设置 WAVEHDR 结构的 lpDatadwBufferLengthdwFlags 成员。 将 dwFlags 成员设置为零。

WAVEHDR 结构的 dwFlagsdwBufferLengthdwLoops 成员可以在调用此函数和 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

另请参阅

波形音频

波形函数