> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GameInputGamepadState

> GameInputGamepadState

Describes the state of a gamepad input device.

## Syntax

```cpp theme={null}
struct GameInputGamepadState
{
    GameInputGamepadButtons buttons;
    float                   leftTrigger;
    float                   rightTrigger;
    float                   leftThumbstickX;
    float                   leftThumbstickY;
    float                   rightThumbstickX;
    float                   rightThumbstickY;
};
```

### Members

*buttons*\

Type: [GameInputGamepadButtons](https://docs.xbox.com/reference/input/gameinput/enums/gameinputgamepadbuttons.md)

The gamepad buttons that are pressed.

*leftTrigger*\

Type: float

Position of left trigger, normalized as a value in the range \[0.0, 1.0].

*rightTrigger*\

Type: float

Position of right trigger, normalized as a value in the range \[0.0, 1.0].

*leftThumbstickX*\

Type: float

Horizontal position of the left thumbstick, normalized as a value in the range \[-1.0, 1.0].

*leftThumbstickY*\

Type: float

Vertical position of the left thumbstick, normalized as a value in the range \[-1.0, 1.0].

*rightThumbstickX*\

Type: float

Horizontal position of the right thumbstick, normalized as a value in the range \[-1.0, 1.0].

*rightThumbstickY*\

Type: float

Vertical position of the right thumbstick, normalized as a value in the range \[-1.0, 1.0].

## Remarks

Used by the [IGameInputReading:GetGamePadState](https://docs.xbox.com/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getgamepadstate.md) method.

For more information, see the [Getting data from readings](https://docs.xbox.com/build/core-features/common/input/overviews/input-readings.md#gettingStateSection) section of [GameInput readings](https://docs.xbox.com/build/core-features/common/input/overviews/input-readings.md). For a code example, see [A simple gamepad input loop](https://docs.xbox.com/build/core-features/common/input/overviews/input-readings.md#sampleSection).

## Requirements

**Header:** GameInput.h

**Supported platforms:** Windows, XBOX One family consoles and XBOX Series consoles

## See also

[Overview of GameInput](https://docs.xbox.com/build/core-features/common/input/overviews/input-overview.md)\
[GameInput](https://docs.xbox.com/reference/input/gameinput/gameinput_members.md)

## Version History

| Version | Changes |
| - | - |
| **v0** | Introduced. |


## Related topics

- [GetGamepadState](https://docs.xbox.com/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getgamepadstate.md)
- [GameInput API members](https://docs.xbox.com/reference/input/gameinput/gameinput_members.md)
- [GameInputGamepadButtons](https://docs.xbox.com/reference/input/gameinput/enums/gameinputgamepadbuttons.md)
- [GameInputGamepadAxes](https://docs.xbox.com/reference/input/gameinput/enums/gameinputgamepadaxes.md)
- [GameInputArcadeStickState](https://docs.xbox.com/reference/input/gameinput/structs/gameinputarcadestickstate.md)