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

製造商標識碼。 製造商標識碼定義於 Manufacturer 和 Product Identifiers中。

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]

識別遊戲桿驅動程式 OEM 的 Null 終止字串。

言論

注意

joystickapi.h 標頭會將 JOYCAPS 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	joystickapi.h （包括 Windows.h）

另請參閱

操縱桿

多媒體遊戲桿結構

joySetCapture