auxGetDevCapsW 函数 (mmeapi.h)

auxGetDevCaps 函数检索给定辅助输出设备的功能。

语法

MMRESULT auxGetDevCapsW(
  UINT_PTR   uDeviceID,
  LPAUXCAPSW pac,
  UINT       cbac
);

参数

uDeviceID

要查询的辅助输出设备的标识符。 指定有效的设备标识符(请参阅以下注释部分),或使用以下常量:

价值 意义
AUX_MAPPER 辅助音频映射器。 如果未安装辅助音频映射器,该函数将返回错误。

pac

指向 AUXCAPS 结构的指针,该结构包含有关设备功能的信息。

cbac

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

返回值

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

返回代码 描述
MMSYSERR_BADDEVICEID
指定的设备标识符范围不足。

言论

uDeviceID 中的设备标识符从零到 1 不等,而不是存在的设备数。 也可以使用AUX_MAPPER。 使用 auxGetNumDevs 函数来确定系统中存在的辅助输出设备数。

注意

mmeapi.h 标头将 auxGetDevCaps 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

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

另请参阅

波形音频

波形函数