auxGetDevCapsW 函数 (mmeapi.h)
auxGetDevCaps 函数检索给定辅助输出设备的功能。
语法
MMRESULT auxGetDevCapsW(
UINT_PTR uDeviceID,
LPAUXCAPSW pac,
UINT cbac
);
参数
uDeviceID
要查询的辅助输出设备的标识符。 指定有效的设备标识符(请参阅以下注释部分),或使用以下常量:
价值 | 意义 |
---|---|
AUX_MAPPER | 辅助音频映射器。 如果未安装辅助音频映射器,该函数将返回错误。 |
pac
指向 AUXCAPS 结构的指针,该结构包含有关设备功能的信息。
cbac
AUXCAPS 结构的大小(以字节为单位)。
返回值
如果成功或错误,则返回MMSYSERR_NOERROR。 可能的错误值包括以下内容。
返回代码 | 描述 |
---|---|
|
指定的设备标识符范围不足。 |
言论
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 |