JOYINFOEX 結構 (搖桿api.h)

JOYINFOEX結構包含搖桿位置、檢視點位置和按鈕狀態的延伸資訊。

語法

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

旗標，指出這個結構中傳回的有效資訊。 不包含有效資訊的成員會設定為零。 定義下列旗標：

旗標	描述
JOY_RETURNALL	相當於設定除了JOY_RETURNRAWDATA以外的所有JOY_RETURN位。
JOY_RETURNBUTTONS	dwButtons成員包含每個搖桿按鈕狀態的有效資訊。
JOY_RETURNCENTERED	將搖桿中性位置置中至每個移動軸的中間值。
JOY_RETURNPOV	dwPOV成員包含以離散單位表示之檢視點控制項的有效資訊。
JOY_RETURNPOVCTS	dwPOV成員包含以連續、第一百度單位表示之檢視點控制項的有效資訊。
JOY_RETURNR	dwRpos成員包含有效的 rudder 腳踏資料。 這項資訊代表另一個 (第四個) 軸。
JOY_RETURNRAWDATA	儲存在此結構中的資料是未布建的搖桿讀數。
JOY_RETURNU	dwUpos成員包含搖桿第五個座標軸的有效資料，如果這類座標軸可用，則傳回零。
JOY_RETURNV	dwVpos成員包含搖桿第六個座標軸的有效資料，如果這類座標軸可用，或傳回零。
JOY_RETURNX	dwXpos成員包含搖桿 X 座標的有效資料。
JOY_RETURNY	dwYpos成員包含搖桿 Y 座標的有效資料。
JOY_RETURNZ	dwZpos成員包含搖桿 Z 座標的有效資料。

 

下列旗標提供資料來校正搖桿，並適用于自訂校正應用程式。

旗標	描述
JOY_CAL_READ3	讀取 x-、y 和 z 座標，並將原始值儲存在 dwXpos、 dwYpos和 dwZpos中。
JOY_CAL_READ4	讀取 rudder 資訊和 x-、y-和 z 座標，並將原始值儲存在dwXpos、dwYpos、dwZpos和dwRpos中。
JOY_CAL_READ5	讀取 rudder 資訊和 x-、y-、z-和 you-座標，並將原始值儲存在 dwXpos、 dwYpos、 dwZpos、 dwRpos和 dwUpos中。
JOY_CAL_READ6	如果搖桿迷你驅動程式存在，則會讀取原始 v 軸資料，以提供資料。 否則傳回零。
JOY_CAL_READALWAYS	即使驅動程式未偵測到裝置，仍可讀取搖桿埠。
JOY_CAL_READRONLY	如果搖桿迷你驅動程式存在，則會讀取 Rudder 資訊，以提供資料並將原始值儲存在 dwRpos中。 否則傳回零。
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中。 否則傳回零。
JOY_CAL_READVONLY	如果搖桿迷你驅動程式存在，則會讀取 v 座標，以提供資料並將原始值儲存在 dwVpos中。 否則傳回零。

dwXpos

目前的 X 座標。

dwYpos

目前的 Y 座標。

dwZpos

目前的 Z 座標。

dwRpos

Rudder 或第四個搖桿軸的目前位置。

dwUpos

目前的第五個座標軸位置。

dwVpos

目前第六個座標軸位置。

dwButtons

32 個搖桿按鈕的目前狀態。 這個成員的值可以設定為 任何JOY_BUTTON n 旗標的組合，其中 n 是 1 到 32 範圍內的值，對應至按下的按鈕。

dwButtonNumber

按下的目前按鈕編號。

dwPOV

檢視點控制項的目前位置。 此成員的值範圍介於 0 到 35，900 之間。 這些值代表每個檢視的角度乘以 100。

dwReserved1

保留;請勿使用。

dwReserved2

保留;請勿使用。

備註

dwSize成員的值也會用來識別結構在傳遞至joyGetPosEx函式時的版本號碼。

大部分具有檢視點控制項的裝置只有五個位置。 設定JOY_RETURNPOV旗標時，會使用下列常數來報告這些位置：

檢視點旗標	描述
JOY_POVBACKWARD	檢視點頂點會向後按下。 值 18，000 代表向) 後 (180.00 度的方向。
JOY_POVCENTERED	檢視點 hat 位於中性位置。 值 -1 表示檢視點 hat 沒有要報告的角度。
JOY_POVFORWARD	向前按下檢視點的 Hat。 值 0 代表 0.00 度的方向， (直接) 。
JOY_POVLEFT	在左側按下檢視點的 Hat。 值 27，000 代表 270.00 度的方向， (左邊) 90.00 度。
JOY_POVRIGHT	右方按下檢視點帽。 值 9，000 代表右邊 (90.00 度的方向) 。

 

預設搖桿驅動程式目前支援這五個離散方向。 如果應用程式只能接受定義的檢視點值，則必須使用JOY_RETURNPOV旗標。 如果應用程式可以接受其他學位讀數，它應該使用 JOY_RETURNPOVCTS 旗標，以在可用時取得連續資料。 JOY_RETURNPOVCTS旗標也支援與 JOY_RETURNPOV 旗標搭配使用的JOY_POV常數。

需求

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

另請參閱

操縱 杆

多媒體搖桿結構

joyGetPosEx