JOYCAPSW 结构 (joystickapi.h)

JOYCAPS 结构包含有关游戏杆功能的信息。

语法

typedef struct tagJOYCAPSW {
  WORD  wMid;
  WORD  wPid;
  WCHAR szPname[MAXPNAMELEN];
  UINT  wXmin;
  UINT  wXmax;
  UINT  wYmin;
  UINT  wYmax;
  UINT  wZmin;
  UINT  wZmax;
  UINT  wNumButtons;
  UINT  wPeriodMin;
  UINT  wPeriodMax;
  UINT  wRmin;
  UINT  wRmax;
  UINT  wUmin;
  UINT  wUmax;
  UINT  wVmin;
  UINT  wVmax;
  UINT  wCaps;
  UINT  wMaxAxes;
  UINT  wNumAxes;
  UINT  wMaxButtons;
  WCHAR szRegKey[MAXPNAMELEN];
  WCHAR szOEMVxD[MAX_JOYSTICKOEMVXDNAME];
} JOYCAPSW, *PJOYCAPSW, *NPJOYCAPSW, *LPJOYCAPSW;

成员

wMid

制造商标识符。 制造商标识符在 制造商和产品标识符中定义。

wPid

产品标识符。 产品标识符在 制造商和产品标识符中定义。

szPname[MAXPNAMELEN]

包含游戏杆产品名称的以 Null 结尾的字符串。

wXmin

最小 X 坐标。

wXmax

最大 X 坐标。

wYmin

最小 Y 坐标。

wYmax

最大 Y 坐标。

wZmin

最小 Z 坐标。

wZmax

最大 Z 坐标。

wNumButtons

游戏杆按钮数。

wPeriodMin

由 joySetCapture 函数捕获时支持的最小轮询频率。

wPeriodMax

joySetCapture 捕获时支持的最大轮询频率。

wRmin

最小 rudder 值。 方向舵是第四个运动轴。

wRmax

最大 rudder 值。 方向舵是第四个运动轴。

wUmin

最小 u 坐标 (第五个轴) 值。

wUmax

最大 u 坐标 (第五个轴) 值。

wVmin

(第六个轴的最小 v 坐标) 值。

wVmax

最大 v 坐标 (第六个轴) 值。

wCaps

游戏杆功能 以下标志定义游戏杆可能具有的单个功能：

标志	描述
JOYCAPS_HASZ	游戏杆具有 z 坐标信息。
JOYCAPS_HASR	游戏杆具有 (第四个轴) 信息方向。
JOYCAPS_HASU	游戏杆具有 u 坐标 (第五轴) 信息。
JOYCAPS_HASV	游戏杆具有 v 坐标 (第六轴) 信息。
JOYCAPS_HASPOV	游戏杆具有视图信息。
JOYCAPS_POV4DIR	游戏杆视图点支持 (居中、向前、后退、左和右) 离散值。
JOYCAPS_POVCTS	游戏杆视点支持连续度轴承。

wMaxAxes

游戏杆支持的最大轴数。

wNumAxes

游戏杆当前使用的轴数。

wMaxButtons

游戏杆支持的最大按钮数。

szRegKey[MAXPNAMELEN]

包含游戏杆注册表项的 Null 终止字符串。

szOEMVxD[MAX_JOYSTICKOEMVXDNAME]

以 Null 结尾的字符串，标识游戏杆驱动程序 OEM。

注解

注意

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

要求

最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	joystickapi.h (包括 Windows.h)

另请参阅

操纵 杆

多媒体游戏杆结构

joySetCapture