Skip to main content
Gets the number of generic controller axes on the device.

Syntax

Parameters

This method has no parameters.

Return value

Type: uint32_t The number of controller axes on the device, or 0 if the device has no controller axes.

Remarks

Controller axes are the raw, unmapped axes of a device. A device has controller axes when the value returned by GetSupportedInput includes GameInputKindControllerAxis. Readings from the device that include GameInputKindControllerAxis report the same number of axes through IGameInputReading::GetControllerAxisCount. Use the returned value to size the array that you pass to GetControllerAxisLabels or to IGameInputReading::GetControllerAxisState. The number of axes doesn’t change while the device is connected. In GameInput v3 and earlier, this information was available from the controllerAxisCount member of the GameInputControllerInfo structure, which was referenced by the controllerInfo 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

See also

Overview of GameInput
GetControllerAxisLabels
IGameInputReading::GetControllerAxisCount
IGameInputReading::GetControllerAxisState
IGameInputDevice

Version History

Last modified on November 5, 2026