メインコンテンツへスキップ
コントロールのラベル、ペダル、シフター、最大ホイール角度など、デバイスのレーシング ホイールのプロパティを取得します。

構文

パラメーター

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

戻り値

型: bool デバイスがレーシング ホイール入力をサポートしていて、info にデータが格納された場合は true。それ以外の場合は false。

解説

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

要件

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

関連項目

GameInput の概要
GameInputRacingWheelInfo
GetSupportedInput
GameInputKind
GameInputLabel
IGameInputReading::GetRacingWheelState
IGameInputDevice

バージョン履歴

最終更新日 2026年11月6日