IGameInputDevice::GetRacingWheelInfo

Retrieves the racing wheel properties of the device, such as its control labels, pedals, shifter, and maximum wheel angle.

Syntax

bool GetRacingWheelInfo(
    GameInputRacingWheelInfo* info
);

Parameters

info _Out_
Type: GameInputRacingWheelInfo* Pointer to a GameInputRacingWheelInfo structure that receives the racing wheel properties of the device. If the device doesn’t support racing wheel input, every member of the structure is set to zero.

Return value

Type: bool true if the device supports racing wheel input and info was filled in; otherwise, false.

Remarks

The GetRacingWheelInfo method copies the racing wheel properties of the device into the caller-provided structure. A device supports racing wheel input when the value returned by GetSupportedInput includes GameInputKindRacingWheel. If the device doesn’t support racing wheel input, GetRacingWheelInfo zero-initializes info and returns false. The hasClutch, hasHandbrake, and hasPatternShifter members report which optional controls are present, minPatternShifterGear and maxPatternShifterGear give the gear range of the pattern shifter, and maxWheelAngle gives the maximum rotation of the wheel. The label members describe the markings printed on the corresponding controls, as GameInputLabel values, so you can show matching prompts in your UI. The extraButtonCount and extraAxisCount members report how many controller buttons and axes the device has beyond the standard racing wheel mapping; use GetExtraButtonIndexes and GetExtraAxisIndexes to locate them in the controller state of a reading. Racing wheel state is read from readings by using IGameInputReading::GetRacingWheelState. The properties returned by this method are fixed for the lifetime of the device, so you can query them once (for example, when the device connects) and cache the result. The following example shows how to query the racing wheel properties of a device.

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

In GameInput v3 and earlier, this information was available from the racingWheelInfo member of the GameInputDeviceInfo structure returned by IGameInputDevice::GetDeviceInfo.

Requirements

Header: GameInput.h Library: gameinput.lib Supported platforms: Windows, XBOX One family consoles and XBOX Series consoles

Version History

Version	Changes
v4	Introduced.

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

Additional pages

Reference

Syntax

Parameters

Return value

Remarks

Requirements

See also

Version History

​Syntax

​Parameters

​Return value

​Remarks

​Requirements

​See also

​Version History

Syntax

Parameters

Return value

Remarks

Requirements

See also

Version History