> ## 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.

# IGameInputDevice::GetRacingWheelInfo

> Recupera as propriedades de volante de corrida do dispositivo, como os rótulos dos controles, os pedais, o câmbio e o ângulo máximo do volante.

Recupera as propriedades de volante de corrida do dispositivo, como os rótulos dos controles, os pedais, o câmbio e o ângulo máximo do volante.

## Sintaxe

```cpp theme={null}
bool GetRacingWheelInfo(
    GameInputRacingWheelInfo* info
);
```

### Parâmetros

*info*   \_Out\_\
Tipo: [GameInputRacingWheelInfo](https://docs.xbox.com/pt-BR/reference/input/gameinput/structs/gameinputracingwheelinfo.md)\*

Ponteiro para uma estrutura `GameInputRacingWheelInfo` que recebe as propriedades de volante de corrida do dispositivo. Se o dispositivo não oferecer suporte à entrada de volante de corrida, todos os membros da estrutura serão definidos como zero.

### Valor retornado

Tipo: bool

`true` se o dispositivo oferecer suporte à entrada de volante de corrida e *info* tiver sido preenchido; caso contrário, `false`.

## Comentários

O método `GetRacingWheelInfo` copia as propriedades de volante de corrida do dispositivo para a estrutura fornecida pelo chamador. Um dispositivo oferece suporte à entrada de volante de corrida quando o valor retornado por [GetSupportedInput](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedinput.md) inclui `GameInputKindRacingWheel`. Se o dispositivo não oferecer suporte à entrada de volante de corrida, `GetRacingWheelInfo` inicializará *info* com zeros e retornará `false`.

Os membros `hasClutch`, `hasHandbrake` e `hasPatternShifter` relatam quais controles opcionais estão presentes, `minPatternShifterGear` e `maxPatternShifterGear` fornecem o intervalo de marchas do câmbio em H, e `maxWheelAngle` fornece a rotação máxima do volante. Os membros de rótulo descrevem as marcações impressas nos controles correspondentes, como valores [GameInputLabel](https://docs.xbox.com/pt-BR/reference/input/gameinput/enums/gameinputlabel.md), para que você possa mostrar prompts correspondentes na sua interface do usuário. Os membros `extraButtonCount` e `extraAxisCount` relatam quantos botões e eixos de controle o dispositivo tem além do mapeamento padrão de volante de corrida; use [GetExtraButtonIndexes](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextrabuttonindexes.md) e [GetExtraAxisIndexes](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextraaxisindexes.md) para localizá-los no estado do controle de uma leitura. O estado do volante de corrida é lido das leituras por meio de [IGameInputReading::GetRacingWheelState](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getracingwheelstate.md).

As propriedades retornadas por este método são fixas durante o tempo de vida do dispositivo, portanto você pode consultá-las uma vez (por exemplo, quando o dispositivo se conecta) e armazenar o resultado em cache.

O exemplo a seguir mostra como consultar as propriedades de volante de corrida de um dispositivo.

```cpp theme={null}
GameInputRacingWheelInfo info;
if (device->GetRacingWheelInfo(&info))
{
    if (info.hasClutch)
    {
        // Enable manual clutch controls.
    }
}
```

No GameInput v3 e anteriores, essas informações estavam disponíveis no membro `racingWheelInfo` da estrutura [GameInputDeviceInfo](https://docs.xbox.com/pt-BR/reference/input/gameinput/deprecated/structs/gameinputdeviceinfo.md) retornada por [IGameInputDevice::GetDeviceInfo](https://docs.xbox.com/pt-BR/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceinfo.md).

## Requisitos

**Cabeçalho:** GameInput.h

**Biblioteca:** gameinput.lib

**Plataformas com suporte:** Windows, consoles da família XBOX One e consoles XBOX Series

## Confira também

[Visão geral do GameInput](https://docs.xbox.com/pt-BR/build/core-features/common/input/overviews/input-overview.md)\
[GameInputRacingWheelInfo](https://docs.xbox.com/pt-BR/reference/input/gameinput/structs/gameinputracingwheelinfo.md)\
[GetSupportedInput](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getsupportedinput.md)\
[GameInputKind](https://docs.xbox.com/pt-BR/reference/input/gameinput/enums/gameinputkind.md)\
[GameInputLabel](https://docs.xbox.com/pt-BR/reference/input/gameinput/enums/gameinputlabel.md)\
[IGameInputReading::GetRacingWheelState](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getracingwheelstate.md)\
[IGameInputDevice](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)

## Histórico de versões

| Versão | Alterações |
| - | - |
| **v4** | Introduzido. |


## Related topics

- [GameInputRacingWheelInfo](https://docs.xbox.com/pt-BR/reference/input/gameinput/structs/gameinputracingwheelinfo.md)
- [IGameInputDevice::GetMouseInfo](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getmouseinfo.md)
- [IGameInputDevice::GetInputReportInfo](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getinputreportinfo.md)
- [IGameInputDevice::GetKeyboardInfo](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getkeyboardinfo.md)
- [IGameInputDevice::GetGamepadInfo](https://docs.xbox.com/pt-BR/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getgamepadinfo.md)