joyGetPosEx 函数 (joystickapi.h)
joyGetPosEx 函数查询游戏杆的位置和按钮状态。
语法
MMRESULT joyGetPosEx(
UINT uJoyID,
LPJOYINFOEX pji
);
参数
uJoyID
要查询的游戏杆的标识符。 uJoyID 的有效值范围为 0 (JOYSTICKID1) 到 15。
pji
指向 JOYINFOEX 结构的指针,该结构包含游戏杆的扩展位置信息和按钮状态。 必须设置 dwSize 和 dwFlags 成员,否则 joyGetPosEx 将失败。 从 joyGetPosEx 返回的信息取决于你在 dwFlags 中指定的标志。
返回值
如果成功,则返回JOYERR_NOERROR或以下错误值之一。
返回代码 | 说明 |
---|---|
|
游戏杆驱动程序不存在。 |
|
传递的参数无效。 |
|
指定的游戏杆标识符无效。 |
|
指定的游戏杆未连接到系统。 |
|
指定的游戏杆标识符无效。 |
注解
此功能提供对扩展设备的访问权限,例如方向键踏板、视点帽、具有大量按钮的设备以及使用最多六个轴的坐标系。 对于使用三个轴或更少且按钮少于四个的游戏杆设备,请使用 joyGetPos 函数。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | joystickapi.h (包括 Windows.h) |
Library | Winmm.lib |
DLL | Winmm.dll |