構文
パラメーター
info _Out_型: GameInputGamepadInfo* デバイスのゲームパッドのプロパティを受け取る
GameInputGamepadInfo 構造体へのポインター。デバイスがゲームパッド入力をサポートしていない場合、構造体のすべてのメンバーは 0 に設定されます。
戻り値
型: bool デバイスがゲームパッド入力をサポートしていて、info にデータが格納された場合はtrue。それ以外の場合は false。
解説
GetGamepadInfo メソッドは、デバイスのゲームパッドのプロパティを、呼び出し元が用意した構造体にコピーします。GetSupportedInput から返される値に GameInputKindGamepad が含まれている場合、そのデバイスはゲームパッド入力をサポートしています。デバイスがゲームパッド入力をサポートしていない場合、GetGamepadInfo は info を 0 で初期化し、false を返します。
supportedLayout メンバーは GameInputGamepadButtons フラグの組み合わせで、デバイスが備えている標準ゲームパッド ボタンを示します。ラベル メンバーは、対応するコントロールに印字されている表示を GameInputLabel 値として記述するため、UI に一致するプロンプトを表示できます。extraButtonCount メンバーと extraAxisCount メンバーは、標準のゲームパッド マッピングを超えてデバイスが備えているコントローラーのボタンと軸の数を報告します。読み取りのコントローラー状態内でそれらの位置を特定するには、GetExtraButtonIndexes と GetExtraAxisIndexes を使用します。ゲームパッドの状態は、IGameInputReading::GetGamepadState を使用して読み取りから取得します。
このメソッドによって返されるプロパティはデバイスの有効期間中は固定されているため、一度 (たとえば、デバイスの接続時に) クエリを実行して結果をキャッシュできます。
次の例は、デバイスのゲームパッドのプロパティをクエリする方法を示しています。
gamepadInfo メンバーから取得できました。
要件
ヘッダー: GameInput.h ライブラリ: gameinput.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体、XBOX Series 本体関連項目
GameInput の概要GameInputGamepadInfo
GetSupportedInput
GameInputKind
GameInputGamepadButtons
GameInputLabel
IGameInputReading::GetGamepadState
IGameInputDevice