joyGetDevCapsW 函数 (joystickapi.h)

joyGetDevCaps 函数查询游戏杆以确定其功能。

语法

MMRESULT joyGetDevCapsW(
  UINT_PTR   uJoyID,
  LPJOYCAPSW pjc,
  UINT       cbjc
);

参数

uJoyID

要查询的操纵杆的标识符。 uJoyID 的有效值范围从 -1 到 15。 -1 值允许检索 JOYCAPS 结构的 szRegKey 成员,无论设备是否存在。

pjc

指向 JOYCAPS 结构的指针,以包含游戏杆的功能。

cbjc

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

返回值

如果成功或以下错误值之一,则返回JOYERR_NOERROR:

返回代码 描述
MMSYSERR_NODRIVER
游戏杆驱动程序不存在,或者指定的游戏杆标识符无效。 指定的游戏杆标识符无效。
MMSYSERR_INVALPARAM
传递了无效参数。

言论

使用 joyGetNumDevs 函数来确定驱动程序支持的游戏杆设备数。

当为 cbjc 参数传递无效值时,此方法将失败。

注意

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

要求

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

另请参阅

游戏杆

多媒体游戏杆函数