RacingWheel Class

Definition

Namespace:

Windows.Gaming.Input

Represents a racing wheel.

public ref class RacingWheel sealed : IGameControllerBatteryInfo

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class RacingWheel final : IGameControllerBatteryInfo

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class RacingWheel : IGameControllerBatteryInfo

Public NotInheritable Class RacingWheel
Implements IGameControllerBatteryInfo

Inheritance

Object Platform::Object IInspectable RacingWheel

Attributes

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implements

IGameController IGameControllerBatteryInfo

Windows requirements

Device family	Windows 10 Anniversary Edition (introduced in 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (introduced in v3.0)

Remarks

Supported Devices

RacingWheel supports any GIP (Gaming Input Protocol) or XUSB compatible racing wheel without force feedback support.

Force feedback is supported on the following device models:

Manufacturer	Model
Logitech	G25
	G27
	G29
	G920
	MOMO Force Feedback Racing Wheel
Thrustmaster	T300RS
	T500RS
	RGT Force Feedback
	T150
	TX
	TMX
Fanatec	CSR
	HID-mode for the Xbox One

Note that to use the devices listed above you should include a HID (Human Interface Device) capability declaration in your app's appxmanifest:

<Capabilities>
  <DeviceCapability Name="humaninterfacedevice">
    <Device Id="any">
      <Function Type="usage:0001 0004"/>
      <Function Type="usage:0001 0005"/>
    </Device>
  </DeviceCapability>
</Capabilities>

Version history

Windows version	SDK version	Value added
1703	15063	FromGameController
1703	15063	TryGetBatteryReport

Properties

HasClutch	Boolean indicating whether the racing wheel has a clutch.
HasHandbrake	Boolean indicating whether the racing wheel has a handbrake.
HasPatternShifter	Boolean indicating whether the racing wheel has a pattern shifter.
Headset	The audio headset attached to the racing wheel.
IsWireless	Gets a value that indicates the wireless state of the racing wheel.
MaxPatternShifterGear	The highest gear of the shifter.
MaxWheelAngle	The maximum angle, in degrees, of the racing wheel.
RacingWheels	The list of all connected racing wheels.
User	The user associated with the racing wheel.
WheelMotor	The force feedback motor for the racing wheel.

Methods

FromGameController(IGameController)	Returns the given game controller as a racing wheel.
GetButtonLabel(RacingWheelButtons)	Retrieves the button label for the specified button.
GetCurrentReading()	Gets a snapshot of the racing wheel's state.
TryGetBatteryReport()	Gets information about the racing wheel's current battery state.

Events

HeadsetConnected	Signals when a headset is attached to the racing wheel.
HeadsetDisconnected	Signals when a headset is disconnected from the racing wheel.
RacingWheelAdded	Signals when a new racing wheel is connected.
RacingWheelRemoved	Signals when a racing wheel is disconnected.
UserChanged	Signals when the user associated with the racing wheel has changed.

See also

• IGameController
• Racing wheel and force feedback
• Input practices for games