> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GameInputRacingWheelInfo

> GameInputRacingWheelInfo

# GameInputRacingWheelInfo

描述賽車方向盤的屬性。

## 語法

```cpp theme={null}
struct GameInputRacingWheelInfo
{
    GameInputLabel menuButtonLabel;
    GameInputLabel viewButtonLabel;
    GameInputLabel previousGearButtonLabel;
    GameInputLabel nextGearButtonLabel;
    GameInputLabel dpadUpLabel;
    GameInputLabel dpadDownLabel;
    GameInputLabel dpadLeftLabel;
    GameInputLabel dpadRightLabel;
    GameInputLabel aButtonLabel;
    GameInputLabel bButtonLabel;
    GameInputLabel xButtonLabel;
    GameInputLabel yButtonLabel;
    GameInputLabel leftShoulderButtonLabel;
    GameInputLabel rightShoulderButtonLabel;
    GameInputLabel leftThumbstickButtonLabel;
    GameInputLabel rightThumbstickButtonLabel;
    bool           hasClutch;
    bool           hasHandbrake;
    bool           hasPatternShifter;
    int32_t        minPatternShifterGear;
    int32_t        maxPatternShifterGear;
    float          maxWheelAngle;
    uint32_t       extraButtonCount;
    uint32_t       extraAxisCount;
};
```

### 成員

*menuButtonLabel*\

類型：[GameInputLabel](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputlabel.md)

功能表按鈕的實體標籤。

*viewButtonLabel*\

類型：[GameInputLabel](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputlabel.md)

檢視按鈕的實體標籤。

*previousGearButtonLabel*\

類型：[GameInputLabel](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputlabel.md)

上一檔選擇器 (按鈕) 的實體標籤。

*nextGearButtonLabel*\

類型：[GameInputLabel](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputlabel.md)

下一檔選擇器 (按鈕) 的實體標籤。

*dpadUpLabel*\

類型：[GameInputLabel](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputlabel.md)

方向鍵上的實體標籤。

*dpadDownLabel*\

類型：[GameInputLabel](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputlabel.md)

方向鍵下的實體標籤。

*dpadLeftLabel*\

類型：[GameInputLabel](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputlabel.md)

方向鍵左的實體標籤。

*dpadRightLabel*\

類型：[GameInputLabel](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputlabel.md)

方向鍵右的實體標籤。

*aButtonLabel*\

類型：[GameInputLabel](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputlabel.md)

**A** 按鈕的實體標籤。

*bButtonLabel*\

類型：[GameInputLabel](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputlabel.md)

**B** 按鈕的實體標籤。

*xButtonLabel*\

類型：[GameInputLabel](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputlabel.md)

**X** 按鈕的實體標籤。

*yButtonLabel*\

類型：[GameInputLabel](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputlabel.md)

**Y** 按鈕的實體標籤。

*leftShoulderButtonLabel*\

類型：[GameInputLabel](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputlabel.md)

左肩按鈕的實體標籤。

*rightShoulderButtonLabel*\

類型：[GameInputLabel](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputlabel.md)

右肩按鈕的實體標籤。

*leftThumbstickButtonLabel*\

類型：[GameInputLabel](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputlabel.md)

左搖桿按鈕的實體標籤。

*hasClutch*\

類型：bool

表示賽車方向盤是否有離合器輸入。

*hasHandbrake*\

類型：bool

表示賽車方向盤是否有手煞車輸入。

*hasPatternShifter*\

類型：bool

表示賽車方向盤是否有 H 型排檔器。

*minPatternShifterGear*\

類型：int32\_t

H 型排檔器的最低檔位。

*maxPatternShifterGear*\

類型：int32\_t

H 型排檔器的最高檔位。

*maxWheelAngle*\

類型：float

賽車方向盤的最大角度。

*extraButtonCount*\

類型：uint32\_t

未對應到賽車方向盤按鈕的裝置按鈕數目。

*extraAxisCount*\

類型：uint32\_t

未對應到賽車方向盤軸的裝置軸數目。

## 備註

此結構用於 [GameInputDeviceInfo](https://docs.xbox.com/zh-TW/reference/input/gameinput/structs/gameinputdeviceinfo.md) 結構中。`GameInputDeviceInfo` 由 [IGameInputDevice::GetDeviceInfo](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceinfo.md) 方法使用。

如需詳細資訊，請參閱 [GameInput 裝置](https://docs.xbox.com/zh-TW/build/core-features/common/input/overviews/input-devices.md)。

## 需求

**標頭：** GameInput.h

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[GameInput 概觀](https://docs.xbox.com/zh-TW/build/core-features/common/input/overviews/input-overview.md)\
[GameInput](https://docs.xbox.com/zh-TW/reference/input/gameinput/gameinput_members.md)

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **v3** | **新增** 8 個按鈕標籤 (`aButtonLabel`、`bButtonLabel`、`xButtonLabel`、`yButtonLabel`、`leftShoulderButtonLabel`、`rightShoulderButtonLabel`、`leftThumbstickButtonLabel`、`rightThumbstickButtonLabel`)、`extraButtonCount`、`extraAxisCount`。 |
| **v0** | 推出。 |

## 附錄：先前版本

### v0、v1、v2

```cpp theme={null}
struct GameInputRacingWheelInfo
{
    GameInputLabel menuButtonLabel;
    GameInputLabel viewButtonLabel;
    GameInputLabel previousGearButtonLabel;
    GameInputLabel nextGearButtonLabel;
    GameInputLabel dpadUpLabel;
    GameInputLabel dpadDownLabel;
    GameInputLabel dpadLeftLabel;
    GameInputLabel dpadRightLabel;
    bool           hasClutch;
    bool           hasHandbrake;
    bool           hasPatternShifter;
    int32_t        minPatternShifterGear;
    int32_t        maxPatternShifterGear;
    float          maxWheelAngle;
};
```


## Related topics

- [GameInputRacingWheelState](https://docs.xbox.com/zh-TW/reference/input/gameinput/structs/gameinputracingwheelstate.md)
- [GameInputLabel](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputlabel.md)
- [GameInputDeviceInfo](https://docs.xbox.com/zh-TW/reference/input/gameinput/structs/gameinputdeviceinfo.md)
- [GameInput API 成員](https://docs.xbox.com/zh-TW/reference/input/gameinput/gameinput_members.md)
- [GameInputRacingWheelButtons](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputracingwheelbuttons.md)