joyGetPosEx 函数 (joystickapi.h)

  • 项目

joyGetPosEx 函数查询游戏杆的位置和按钮状态。

语法

MMRESULT joyGetPosEx(
  UINT        uJoyID,
  LPJOYINFOEX pji
);

参数

uJoyID

要查询的游戏杆的标识符。 uJoyID 的有效值范围为 0 (JOYSTICKID1) 到 15。

pji

指向 JOYINFOEX 结构的指针，该结构包含游戏杆的扩展位置信息和按钮状态。 必须设置 dwSize 和 dwFlags 成员，否则 joyGetPosEx 将失败。 从 joyGetPosEx 返回的信息取决于你在 dwFlags 中指定的标志。

返回值

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

返回代码 说明
MMSYSERR_NODRIVER
 游戏杆驱动程序不存在。
MMSYSERR_INVALPARAM
 传递的参数无效。
MMSYSERR_BADDEVICEID
 指定的游戏杆标识符无效。
JOYERR_UNPLUGGED
 指定的游戏杆未连接到系统。
JOYERR_PARMS
 指定的游戏杆标识符无效。

注解

此功能提供对扩展设备的访问权限，例如方向键踏板、视点帽、具有大量按钮的设备以及使用最多六个轴的坐标系。 对于使用三个轴或更少且按钮少于四个的游戏杆设备，请使用 joyGetPos 函数。

要求

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

另请参阅

操纵 杆

多媒体游戏杆函数