WindowsAPI之joystickapi(游戏摇杆)头文件4

最新推荐文章于 2022-07-17 16:40:59 发布

海洋想想

最新推荐文章于 2022-07-17 16:40:59 发布

阅读量2.8k

点赞数 1

分类专栏： joystick 文章标签：游戏 c++ api windows

本文链接：https://blog.csdn.net/qq_17525633/article/details/106218907

版权

joystick 专栏收录该内容

5 篇文章 12 订阅

订阅专栏

文章目录

函数joyGetPosEx
结构体JOYINFOEX

函数joyGetPosEx

函数joyGetPosEx查询操作杆的位置信息以及按键状态。

语法

MMRESULT joyGetPosEx(
  UINT        uJoyID,
  LPJOYINFOEX pji
);

参数

uJoyID
被查询操纵杆的标识符。该参数的有效值范围为0到15。

pji
指向结构体 JOYINFOEX的指针。该结构体包含操纵杆更加丰富的位置信息以及按键状态。你必须设置dwSize和dwFlags成员，否则 joyGetPosEx函数将返回失败。 joyGetPosEx函数返回的值取决于你在dwFlags中设置的标志。

返回值

如果函数执行正确，则返回 JOYERR_NOERROR。否则，会返回以下错误值：

错误代码	描述
MMSYSERR_NODRIVER	该操纵杆的驱动已经丢失。
MMSYSERR_INVALPARAM	传递了无效的参数。
MMSYSERR_BADDEVICEID	该操纵杆标识符无效。
JOYERR_UNPLUGGED	该操纵杆没有连接到系统。
JOYERR_PARMS	(~~该操纵杆标识符无效。~~ )应该是参数出现问题。

/* joystick error return values */
#define JOYERR_NOERROR        (0)                  /* no error */
#define JOYERR_PARMS          (JOYERR_BASE+5)      /* bad parameters */
#define JOYERR_NOCANDO        (JOYERR_BASE+6)      /* request not completed */
#define JOYERR_UNPLUGGED      (JOYERR_BASE+7)      /* joystick is unplugged */

/* general error return values */
#define MMSYSERR_NOERROR      0                    /* no error */
#define MMSYSERR_ERROR        (MMSYSERR_BASE + 1)  /* unspecified error */
#define MMSYSERR_BADDEVICEID  (MMSYSERR_BASE + 2)  /* device ID out of range */
#define MMSYSERR_NOTENABLED   (MMSYSERR_BASE + 3)  /* driver failed enable */
#define MMSYSERR_ALLOCATED    (MMSYSERR_BASE + 4)  /* device already allocated */
#define MMSYSERR_INVALHANDLE  (MMSYSERR_BASE + 5)  /* device handle is invalid */
#define MMSYSERR_NODRIVER     (MMSYSERR_BASE + 6)  /* no device driver present */
#define MMSYSERR_NOMEM        (MMSYSERR_BASE + 7)  /* memory allocation error */
#define MMSYSERR_NOTSUPPORTED (MMSYSERR_BASE + 8)  /* function isn't supported */
#define MMSYSERR_BADERRNUM    (MMSYSERR_BASE + 9)  /* error value out of range */
#define MMSYSERR_INVALFLAG    (MMSYSERR_BASE + 10) /* invalid flag passed */
#define MMSYSERR_INVALPARAM   (MMSYSERR_BASE + 11) /* invalid parameter passed */
#define MMSYSERR_HANDLEBUSY   (MMSYSERR_BASE + 12) /* handle being used */
                                                   /* simultaneously on another */
                                                   /* thread (eg callback) */
#define MMSYSERR_INVALIDALIAS (MMSYSERR_BASE + 13) /* specified alias not found */
#define MMSYSERR_BADDB        (MMSYSERR_BASE + 14) /* bad registry database */
#define MMSYSERR_KEYNOTFOUND  (MMSYSERR_BASE + 15) /* registry key not found */
#define MMSYSERR_READERROR    (MMSYSERR_BASE + 16) /* registry read error */
#define MMSYSERR_WRITEERROR   (MMSYSERR_BASE + 17) /* registry write error */
#define MMSYSERR_DELETEERROR  (MMSYSERR_BASE + 18) /* registry delete error */
#define MMSYSERR_VALNOTFOUND  (MMSYSERR_BASE + 19) /* registry value not found */
#define MMSYSERR_NODRIVERCB   (MMSYSERR_BASE + 20) /* driver does not call DriverCallback */
#define MMSYSERR_MOREDATA     (MMSYSERR_BASE + 21) /* more data to be returned */
#define MMSYSERR_LASTERROR    (MMSYSERR_BASE + 21) /* last error in range */

#define MMSYSERR_BASE          0
#define WAVERR_BASE            32
#define MIDIERR_BASE           64
#define TIMERR_BASE            96
#define JOYERR_BASE            160
#define MCIERR_BASE            256
#define MIXERR_BASE            1024

说明

该函数包含更加丰富的设备信息，例如方向舵值(rudder pedals)，POV帽子( point-of-view hats)，带有很多按钮的设备，运动坐标轴达到六轴以上。若操纵杆的运动坐标轴小于或者等于3，且按键数量小于4，可以使用函数 joyGetPos。

支持

名称	条件
最低支持客户端	Windows 2000 Professional [desktop apps only]
最低支持服务器	Windows 2000 Server [desktop apps only]
目标平台	Windows
头文件	joystickapi.h (include Windows.h)
LIB	Winmm.lib
DLL	Winmm.dll

结构体JOYINFOEX

结构体JOYINFOEX中包含更加丰富的操纵杆信息。这些信息包括操纵杆位置，POV位置以及按键状态。

语法

typedef struct joyinfoex_tag {
  DWORD dwSize;
  DWORD dwFlags;
  DWORD dwXpos;
  DWORD dwYpos;
  DWORD dwZpos;
  DWORD dwRpos;
  DWORD dwUpos;
  DWORD dwVpos;
  DWORD dwButtons;
  DWORD dwButtonNumber;
  DWORD dwPOV;
  DWORD dwReserved1;
  DWORD dwReserved2;
} JOYINFOEX, *PJOYINFOEX, *NPJOYINFOEX, *LPJOYINFOEX;

成员

dwSize

这个结构体的容量，单位是字节。

dwFlags
结构体返回的标志位，含有有效信息。不包含有效信息成员设置为0。以下定义这些标志：

标志	描述
JOY_RETURNALL	等同于设置了除JOY_RETURNRAWDATA之外的所有JOY_RETURN 位。
JOY_RETURNBUTTONS	成员 dwButtons 包含有效信息。信息包含操纵杆按键状态。
JOY_RETURNCENTERED	将操纵杆空挡位置居中到每个移动轴的中间值。
JOY_RETURNPOV	成员dwPOV包含关于POV控制的有效信息，用离散值表示。
JOY_RETURNPOVCTS	成员dwPOV包含关于POV的有效信息，用连续值表示，单位是0.01度。
JOY_RETURNR	成员dwRpos包含有效的舵值信息。这个信息表示第四轴运动信息。
JOY_RETURNRAWDATA	是结构体中存储的数据是未校准的操纵杆读数。
JOY_RETURNU	成员dwUpos包含有效信息，关于操纵杆的第五轴运动信息。若第五轴无效，返回0。
JOY_RETURNV	成员dwVpos包含有效信息，关于操纵杆的第六轴运动信息。若第六轴无效，返回0。
JOY_RETURNX	成员dwXpos 包含有效信息，关于操纵杆的X轴。
JOY_RETURNY	成员dwYpos 包含有效信息，关于操纵杆的Y轴。
JOY_RETURNZ	成员dwZpos 包含有效信息，关于操纵杆的Z轴。

以下标志提供校准操纵杆的数据，用于自定义的校准应用程序。

标志	描述
JOY_CAL_READ3	读取x，y以及z轴坐标，且将原始值存储在 dwXpos，dwYpos，和 dwZpos中。
JOY_CAL_READ4	读取x，y，z轴坐标，且将原始值存储在 dwXpos，dwYpos， dwZpos和dwRpos.中。
JOY_CAL_READ5	读取x，y，z和u轴坐标，且将原始值存储在 dwXpos，dwYpos， dwZpos，dwRpos和dwUpos.中。
JOY_CAL_READ6	若驱动程序存在，则读取v轴原始数据。否则返回0。
JOY_CAL_READALWAYS	即使驱动没有读取到设备，也要读取操纵杆端口。
JOY_CAL_READRONLY	读取舵值信息。若操纵杆的驱动程序存在，将会提供次数据且存储在dwRpos中，否则返回0。
JOY_CAL_READXONLY	读取x轴坐标且将原始(未校准)值存放在dwXpos中。
JOY_CAL_READXYONLY	读取x轴和y轴坐标，且将原始值存在 dwXpos和dwYpos中。
JOY_CAL_READYONLY	读取y轴坐标且将原始(未校准)值存放在dwYpos中。
JOY_CAL_READZONLY	读取z轴坐标且将原始(未校准)值存放在dwZpos中。
JOY_CAL_READUONLY	读取u轴坐标。若操纵杆的驱动程序存在，将会提供次数据且存储在dwUpos中，否则返回0。
JOY_CAL_READVONLY	读取v轴坐标。若操纵杆的驱动程序存在，将会提供次数据且存储在dwVpos中，否则返回0。

#define JOY_RETURNX             0x00000001l
#define JOY_RETURNY             0x00000002l
#define JOY_RETURNZ             0x00000004l
#define JOY_RETURNR             0x00000008l
#define JOY_RETURNU             0x00000010l     /* axis 5 */
#define JOY_RETURNV             0x00000020l     /* axis 6 */
#define JOY_RETURNPOV           0x00000040l
#define JOY_RETURNBUTTONS       0x00000080l
#define JOY_RETURNRAWDATA       0x00000100l
#define JOY_RETURNPOVCTS        0x00000200l
#define JOY_RETURNCENTERED      0x00000400l
#define JOY_USEDEADZONE         0x00000800l
#define JOY_RETURNALL           (JOY_RETURNX | JOY_RETURNY | JOY_RETURNZ | \
                                 JOY_RETURNR | JOY_RETURNU | JOY_RETURNV | \
                                 JOY_RETURNPOV | JOY_RETURNBUTTONS)
#define JOY_CAL_READALWAYS      0x00010000l
#define JOY_CAL_READXYONLY      0x00020000l
#define JOY_CAL_READ3           0x00040000l
#define JOY_CAL_READ4           0x00080000l
#define JOY_CAL_READXONLY       0x00100000l
#define JOY_CAL_READYONLY       0x00200000l
#define JOY_CAL_READ5           0x00400000l
#define JOY_CAL_READ6           0x00800000l
#define JOY_CAL_READZONLY       0x01000000l
#define JOY_CAL_READRONLY       0x02000000l
#define JOY_CAL_READUONLY       0x04000000l
#define JOY_CAL_READVONLY       0x08000000l

dwXpos

当前X轴坐标值。

dwYpos

当前Y轴坐标值。

dwZpos

当前Z轴坐标值。

dwRpos

当前舵的位置或者第四坐标值。

dwUpos

当前第五坐标值。

dwVpos

当前第六坐标值。

dwButtons

操纵杆当前32个按键状态。该值可以是标志JOY_BUTTON n的任意组合，其中，n的取值范围为1到32，对应相应被按下的按键。

dwButtonNumber

当前被按下的按键数量。

dwPOV

POV控制的当前位置。该成员的值取值范围为0到35900。该值表示角度，单位为0.01度。

dwReserved1

保留未用。

dwReserved2

保留未用。

说明

成员dwSize的值还用于标识传递给函数joyGetPostEx时，结构体的版本号。
大多数包含POV控制的设备有5个位置。当标志JOY_RETURNPOV被置位时，这些位置被一下常数替代。

POV标志	描述
JOY_POVBACKWARD	POV帽子向后按下。值18000表示180.00度的方向（向后）。
JOY_POVCENTERED	POV帽子在中立位置. 值-1表示POV帽子没有角度需要报告。
JOY_POVFORWARD	POV帽子向前按下. 值0表示0.00度的方向（向前）。
JOY_POVLEFT	POV帽子向左按下. 值27000表示270.00度的方向（向左）。
JOY_POVRIGHT	POV帽子向右按下. 值9000表示90.00度的方向 (向右)。

默认的操纵杆驱动支持五个离散方向。若应用程序只能接受被定义的POV值，则使用标志JOY_RETURNPOV。若应用可以接受其他角度读数，就应该使用标志JOY_RETURNPOVCTS获取连续的数据(若数据有效的话)。标志JOY_RETURNPOVCTS同样支持与标志JOY_RETURNPOV一起使用的 JOY_POV常量。

支持

名称	条件
最低支持客户端	Windows 2000 Professional [desktop apps only]
最低支持服务器	Windows 2000 Server [desktop apps only]
头文件	joystickapi.h (include Windows.h)

海洋想想

关注

1
点赞
踩
12

收藏

觉得还不错? 一键收藏
0
评论
WindowsAPI之joystickapi(游戏摇杆)头文件4

文章目录函数joyGetPosEx语法参数返回值函数joyGetPosEx函数joyGetPosEx查询操作杆的位置信息以及按键状态。语法MMRESULT joyGetPosEx( UINT uJoyID, LPJOYINFOEX pji);参数uJoyID被查询操纵杆的标识符。该参数的有效值范围为0到15。pji指向结构体 JOYINFOEX的指针。该结构体包含操纵杆更加丰富的位置信息以及按键状态。你必须设置dwSize和dwFlags成员，否则 joyGetP
复制链接

扫一扫