WindowsAPI之joystickapi(游戏摇杆)头文件4
文章目录
- 函数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) |
WindowsAPI之joystickapi(游戏摇杆)头文件4相关推荐
- Windows API 之joystickapi(游戏摇杆)头文件2
文章目录 前言 函数joyGetDevCaps 语法 参数 返回值 补充 支持 结构体 JOYCAPS 语法 成员 支持 前言 在上篇博文中,已经介绍了windows底层对于游戏摇杆的支持头文件. 在 ...
- c++ max 的头文件_学用C/C++编写小游戏程序(2.2 打字练习游戏)
2.2 打字练习游戏(随机数与特殊输入) 有了上面的绘制简单动画的技术,现在来看一下简易的打字练习游戏. [程序2-2]编写一个简易的打字训练游戏:计算机每次随机生成一个小写英文字符,从屏幕一行的左侧 ...
- c++开发游戏头文件
文章目录 1.引言 2.头文件 3.判断按键 4.函数 1.引言 为了简化游戏开发,所以写了一个游戏头文件方便使用. 2.头文件 #include <bits/stdc++.h> #inc ...
- 【C/C++语法外功】C/C++头文件一览[轉]
c++常用函数所在头文件一览 函数 包含 类别 功能 _atold math.h ...
- c++ 1:非MFC工程使用MFC库时的问题及解决办法(如果要用CString或者提示windows头文件重复包含)...
非MFC工程使用MFC库时的问题及解决办法(如果要用CString或者提示windows头文件重复包含) vc6和vc71的工程向导中都包含非MFC的工程,诸如win32 console projec ...
- android 游戏遥感,Android2.2+游戏摇杆 MOPS魅影T800评测
为游戏而生:MOPS魅影T800 Android凭借着自身出色的设计以及丰富的第三方软件应用的支持,目前已经成为了最炙手可热的智能手机系统之一,很多朋友对Android感兴趣是因为其具有非常丰富的软件 ...
- C语言项目-精忠报国-第二天-COORD windows.h头文件/conio.h getch()函数/game.c showMap()函数 文字突出/怪物计数与打印/随机攻击力 stblib.h
项目来源:老九君 项目名称:精忠报国之笑傲江湖 视频课地址:网易云课堂 基本功能/架构: 第二天 今天看得比较快,基本把这个项目结束了吧,明天再仔细看一下有没有遗漏的这项目就应该算是结束了.项目难度的 ...
- 【Unity插件】游戏摇杆Joystick
文章目录 前言 一.Joystick摇杆类型 二.摇杆基本属性 三.摇杆使用方法 四.其他功能及扩展 总结 前言 最近开发很多游戏Demo中都有用到游戏摇杆Joystick.个人还是挺喜欢用这个插件的 ...
- [转载]C/C++头文件一览
本文转自:http://blog.csdn.net/qq_33583069/article/details/51364514 C/C++头文件一览 传统 C++ #include <assert ...
最新文章
- 基于Mozilla Thunderbird的扩展开发(四)---修改Thunderbird源代码实现自动保存附件...
- 制作多域名(SAN/UCC)CSR(证书请求文件)
- redo log重做日志缓冲
- 判断一个单链表中是否有环
- 给你的Mr.Right画张择偶地图像
- JavaScript(ES6)传播算子和rest参数简介
- 【Spark】Spark 报错 error writing stream metadata exitcode=1073741515
- 提示,请选择有效的文件
- IIS添加MIME类型支持 rmvb 等播放
- Linux下的Libsvm使用历程录
- 操作系统实验报告一 进程调度
- 第012课 内存控制器与SDRAM
- C语言优先级顺序表口诀
- 饥荒dns服务器未响应,DNS服务器未响应怎么办
- 小学身高体重测试软件,儿童身高体重在线测评
- 金庸武侠内功排行榜TOP10
- 服务评价器连接计算机后无法启动,四键评价器服务端+客户端(附驱动)
- cesium中的飞行动画fly
- 日本瑞萨renesas MCU---汽车电子MCU的不二之选
- iiOS 6 新特性