Skip to main content

GetExtraAxisIndexes

Gets the controller axis indexes of the extra axes on the device for a given input kind.

Syntax

Parameters

inputKind   _In_
Type: GameInputKind
The input kind whose extra axis indexes are being requested. extraAxisCount   _In_
Type: uint32_t
Expected count of axis indexes for extra axes. This number can be retrieved by calling GetExtraAxisCount. extraAxisIndexes   _Out_writes_(extraAxisCount)_
Type: uint8_t*
Pointer to the array of axis indexes.

Return value

Type: HRESULT Function result.

Remarks

The GetExtraAxisIndexes method retrieves the controller axis indexes of the extra axes that are present on the device for a given input kind. Extra axes are controller axes that exist on the physical device but are not part of the standard mapping for the specified input kind. Before calling this method, you should first call GetExtraAxisCount to determine how many extra axes are available and pass that count as the extraAxisCount parameter. The following code example demonstrates how to make use of a gamepad’s extra axes:

Requirements

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

See also

GameInputKind
GetExtraAxisCount
GetExtraButtonIndexes
IGameInputDevice

Version History

Last modified on August 31, 2026