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