JOCAPSW 結構 (搖桿api.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 值。 Rudder 是移動的第四個軸。

wRmax

Rudder 值上限。 Rudder 是移動的第四個軸。

wUmin

最小 u 座標 (第五個座標軸) 值。

wUmax

最大 u 座標 (第五個座標軸) 值。

wVmin

最小 v 座標 (第六個座標軸) 值。

wVmax

第六個座標 (第六個座標軸) 值上限。

wCaps

搖桿功能 下列旗標會定義搖桿可能具有的個別功能：

旗標	描述
JOYCAPS_HASZ	搖桿具有 Z 座標資訊。
JOYCAPS_HASR	搖桿具有第四個座標軸) 資訊的 rudder (。
JOYCAPS_HASU	搖桿具有 u 座標 (第五個座標軸) 資訊。
JOYCAPS_HASV	搖桿具有 v 座標 (第六個座標軸) 資訊。
JOYCAPS_HASPOV	搖桿具有檢視點資訊。
JOYCAPS_POV4DIR	搖桿檢視點支援 (置中、向前、向後、向左和向右) 的離散值。
JOYCAPS_POVCTS	搖桿檢視點支援連續度承載。

wMaxAxes

搖桿支援的最大座標軸數目。

wNumAxes

搖桿目前使用的座標軸數目。

wMaxButtons

搖桿支援的按鈕數目上限。

szRegKey[MAXPNAMELEN]

Null 終止的字串，其中包含搖桿的登錄機碼。

szOEMVxD[MAX_JOYSTICKOEMVXDNAME]

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

備註

注意

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

需求

最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	jostickapi.h (包含 Windows.h)

另請參閱

操縱 杆

多媒體搖桿結構

joySetCapture