waveOutGetDevCaps 函数 (mmeapi.h)

waveOutGetDevCaps 函数检索给定波形音频输出设备的功能。

语法

MMRESULT waveOutGetDevCaps(
  UINT          uDeviceID,
  LPWAVEOUTCAPS pwoc,
  UINT          cbwoc
);

参数

uDeviceID

波形音频输出设备的标识符。 它可以是设备标识符,也可以是开放波形音频输出设备的句柄。

pwoc

指向 WAVEOUTCAPS 结构的指针,该结构要填充有关设备功能的信息。

cbwoc

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

返回值

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

返回代码 说明
MMSYSERR_BADDEVICEID
指定的设备标识符在范围外。
MMSYSERR_NODRIVER
不存在设备驱动程序。
MMSYSERR_NOMEM
无法分配或锁定内存。

注解

使用 waveOutGetNumDevs 函数确定系统中存在的波形音频输出设备的数量。 如果 uDeviceID 参数指定的值是设备标识符,则该值可能从零变化到 1 个,而不是存在的设备数。 WAVE_MAPPER常量也可以用作设备标识符。 仅将 (或更少) 信息的 cbwoc 字节复制到 pwoc 指向的位置。 如果 cbwoc 为零,则不复制任何内容,函数返回零。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 mmeapi.h (包括 Windows.h)
Library Winmm.lib
DLL Winmm.dll

另请参阅

波形音频

波形函数