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