waveOutGetDevCaps 函数检索给定波形音频输出设备的功能。
Syntax
MMRESULT waveOutGetDevCaps(
UINT uDeviceID,
LPWAVEOUTCAPS pwoc,
UINT cbwoc
);
参数
uDeviceID
波形音频输出设备的标识符。 它可以是设备标识符,也可以是开放波形音频输出设备的句柄。
pwoc
指向要填充设备功能的 WAVEOUTCAPS 结构的指针。
cbwoc
WAVEOUTCAPS 结构的大小(以字节为单位)。
返回值
如果成功或错误,则返回MMSYSERR_NOERROR。 可能的错误值包括以下内容。
| 返回代码 | Description |
|---|---|
| MMSYSERR_BADDEVICEID | 指定的设备标识符范围不足。 |
| MMSYSERR_NODRIVER | 不存在任何设备驱动程序。 |
| MMSYSERR_NOMEM | 无法分配或锁定内存。 |
注解
使用 waveOutGetNumDevs 函数确定系统中存在的波形音频输出设备的数量。 如果 uDeviceID 参数指定的值是设备标识符,则该值可能会从零更改为一个小于现有设备数。 WAVE_MAPPER常量还可以用作设备标识符。 仅 将 cbwoc 字节(或更少)的信息复制到 pwoc 指向的位置。 如果 cbwoc 为零,则不会复制任何内容,并且函数返回零。
要求
| Requirement | 价值 |
|---|---|
| 最低支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 支持的最低服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows操作系统 |
| Header | mmeapi.h (包括 Windows.h) |
| Library | Winmm.lib |
| DLL | Winmm.dll |