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

この構造体で返される有効な情報を示すフラグ。 有効な情報を含まないメンバーは 0 に設定されます。 次のフラグが定義されています。

フラグ	説明
JOY_RETURNALL	JOY_RETURNRAWDATAを除くすべてのJOY_RETURNビットを設定することと同じです。
JOY_RETURNBUTTONS	dwButtons メンバーには、各ジョイスティック ボタンの状態に関する有効な情報が含まれています。
JOY_RETURNCENTERED	ジョイスティックのニュートラル位置を、各動き軸の中央の値に中央揃えします。
JOY_RETURNPOV	dwPOV メンバーには、ポイント オブ ビュー コントロールに関する有効な情報が含まれています。不連続単位で表されます。
JOY_RETURNPOVCTS	dwPOV メンバーには、連続する 100 分の 1 単位で表される視点コントロールに関する有効な情報が含まれています。
JOY_RETURNR	dwRpos メンバーには、有効なラダー ペダル データが含まれています。 この情報は、別の (4 番目の) 軸を表します。
JOY_RETURNRAWDATA	この構造に格納されているデータは、調整されていないジョイスティックの測定値です。
JOY_RETURNU	dwUpos メンバーには、ジョイスティックの 5 番目の軸に対する有効なデータが含まれます (そのような軸が使用可能な場合)、それ以外の場合は 0 を返します。
JOY_RETURNV	dwVpos メンバーには、ジョイスティックの 6 番目の軸の有効なデータが含まれます (そのような軸が使用可能な場合)、それ以外の場合は 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-、you 座標を読み取り、生の値を 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	データを提供し、 dwUpos に生の値を格納するジョイスティック ミニ ドライバーが存在する場合は、u 座標を読み取ります。 それ以外の場合は 0 を返します。
JOY_CAL_READVONLY	データを提供し、生の値を dwVpos に格納するジョイスティック ミニ ドライバーが存在する場合は、v 座標を読み取ります。 それ以外の場合は 0 を返します。

dwXpos

現在の X 座標。

dwYpos

現在の Y 座標。

dwZpos

現在の Z 座標。

dwRpos

ラダーまたは第4ジョイスティック軸の現在位置。

dwUpos

現在の 5 番目の軸の位置。

dwVpos

現在の 6 番目の軸の位置。

dwButtons

32個のジョイスティックボタンの現在の状態。 このメンバーの値は、JOY_BUTTON n フラグの任意の組み合わせに設定できます。 ここで n は、押されたボタンに対応する 1 ~ 32 の範囲の値です。

dwButtonNumber

押された現在のボタン番号。

dwPOV

ポイント オブ ビュー コントロールの現在の位置。 このメンバーの値は、0 ~ 35,900 の範囲です。 これらの値は、各ビューの角度 (度数) に 100 を乗算して表します。

dwReserved1

予約済みです。使わないでください。

dwReserved2

予約済みです。使わないでください。

解説

dwSize メンバーの値は、構造体が joyGetPosEx 関数に渡されるときに、構造体のバージョン番号を識別するためにも使用されます。

ポイント オブ ビュー コントロールを持つほとんどのデバイスには、5 つの位置しかありません。 JOY_RETURNPOV フラグを設定すると、次の定数を使用してこれらの位置が報告されます。

ポイント オブ ビュー フラグ	説明
JOY_POVBACKWARD	視点の帽子は後方に押される。 値 18,000 は、180.00 度 (背面) の向きを表します。
JOY_POVCENTERED	視点の帽子は中立の位置にある。 値 -1 は、視点の帽子にレポートする角度がないことを意味します。
JOY_POVFORWARD	視点の帽子は前方に押されます。 値 0 は、0.00 度 (真先) の向きを表します。
JOY_POVLEFT	ポイントオブビューハットが左に押されています。 値 27,000 は、270.00 度 (左に 90.00 度) の向きを表します。
JOY_POVRIGHT	ポイント オブ ビュー の帽子が右に押されます。 値 9,000 は、90.00 度 (右側) の向きを表します。

 

既定のジョイスティック ドライバーでは、現在、これら 5 つの個別の方向がサポートされています。 アプリケーションが定義済みの視点の値のみを受け入れることができる場合は、JOY_RETURNPOV フラグを使用する必要があります。 アプリケーションが他の学位の読み取り値を受け入れる場合は、JOY_RETURNPOVCTS フラグを使用して、連続データが使用可能な場合は取得する必要があります。 JOY_RETURNPOVCTS フラグは、JOY_RETURNPOV フラグで使用されるJOY_POV定数もサポートしています。

要件

サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
Header	ジョイスティックapi.h (Windows.h を含む)

関連項目

ジョイスティック

マルチメディアジョイスティック構造

joyGetPosEx