waveInGetDevCaps 函数 (mmeapi.h)

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

Syntax

MMRESULT waveInGetDevCaps(
  UINT         uDeviceID,
  LPWAVEINCAPS pwic,
  UINT         cbwic
);

参数

uDeviceID

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

pwic

指向要填充设备功能信息的 WAVEINCAPS 结构的指针。

cbwic

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

返回值

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

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

注解

使用此函数可确定系统中存在的波形音频输入设备的数量。 如果 uDeviceID 参数指定的值是设备标识符,则该值可能会从零更改为一个小于现有设备数。 WAVE_MAPPER常量还可以用作设备标识符。 仅 将信息 cbwic 字节(或更少)复制到 pwic 指向的位置。 如果 cbwic 为零,则不会复制任何内容,并且函数返回零。

要求

Requirement 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows操作系统
Header mmeapi.h (包括 Windows.h)
Library Winmm.lib
DLL Winmm.dll

另请参阅

波形音频波形函数