Skip to main content

GetExtraButtonIndexes

Gets the controller button indexes of the extra buttons on the device for a given input kind.

Syntax

Parameters

inputKind   _In_
Type: GameInputKind
The input kind whose extra button indexes are being requested. extraButtonCount   _In_
Type: uint32_t
Expected count of button indexes for extra buttons. This number can be retrieved by calling GetExtraButtonCount. extraButtonIndexes   _Out_writes_(extraButtonCount)_
Type: uint8_t*
Pointer to the array of button indexes.

Return value

Type: HRESULT Function result.

Remarks

Extra buttons are controller buttons 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 GetExtraButtonCount to determine how many extra buttons are available and pass that count as the extraButtonCount parameter. The next code snippet demonstrates how to make use of a gamepad’s extra buttons:

Requirements

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

See also

GameInputKind
GetExtraButtonCount
GetExtraAxisIndexes
IGameInputDevice

Version History

Last modified on August 31, 2026