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 中的设备标识符从 0 到 1 不等，比存在的设备数少一个。也可以使用AUX_MAPPER。使用 auxGetNumDevs 函数确定系统中存在的辅助输出设备数。

注意

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

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