メインコンテンツへスキップ
ボタン、ハット スイッチ、軸のラベルなど、デバイスのフライト スティックのプロパティを取得します。

構文

パラメーター

info   _Out_
型: GameInputFlightStickInfo*
デバイスのフライト スティックのプロパティを受け取る GameInputFlightStickInfo 構造体へのポインター。デバイスがフライト スティック入力をサポートしていない場合、構造体のすべてのメンバーは 0 に設定されます。

戻り値

型: bool デバイスがフライト スティック入力をサポートしていて、info にデータが格納された場合は true。それ以外の場合は false。

解説

GetFlightStickInfo メソッドは、デバイスのフライト スティックのプロパティを、呼び出し元が用意した構造体にコピーします。GetSupportedInput から返される値に GameInputKindFlightStick が含まれている場合、そのデバイスはフライト スティック入力をサポートしています。デバイスがフライト スティック入力をサポートしていない場合、GetFlightStickInfo は info を 0 で初期化し、false を返します。 ラベル メンバーは、対応するコントロールに印字されている表示を GameInputLabel 値として記述するため、UI に一致するプロンプトを表示できます。extraButtonCount メンバーと extraAxisCount メンバーは、標準のフライト スティック マッピングを超えてデバイスが備えているコントローラーのボタンと軸の数を報告します。読み取りのコントローラー状態内でそれらの位置を特定するには、GetExtraButtonIndexes と GetExtraAxisIndexes を使用します。フライト スティックの状態は、IGameInputReading::GetFlightStickState を使用して読み取りから取得します。 このメソッドによって返されるプロパティはデバイスの有効期間中は固定されているため、一度 (たとえば、デバイスの接続時に) クエリを実行して結果をキャッシュできます。 次の例は、デバイスのフライト スティックのプロパティをクエリする方法を示しています。
GameInput v3 以前では、この情報は IGameInputDevice::GetDeviceInfo から返される GameInputDeviceInfo 構造体の flightStickInfo メンバーから取得できました。

要件

ヘッダー: GameInput.h ライブラリ: gameinput.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体、XBOX Series 本体

関連項目

GameInput の概要
GameInputFlightStickInfo
GetSupportedInput
GameInputKind
GameInputLabel
IGameInputReading::GetFlightStickState
IGameInputDevice

バージョン履歴

最終更新日 2026年11月6日