> ## 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.

# GameInputSwitchPosition

> GameInputSwitchPosition

Enumerates positions of a switch on an input device.

## Syntax

```cpp theme={null}
enum GameInputSwitchPosition
{
    GameInputSwitchCenter    = 0,
    GameInputSwitchUp        = 1,
    GameInputSwitchUpRight   = 2,
    GameInputSwitchRight     = 3,
    GameInputSwitchDownRight = 4,
    GameInputSwitchDown      = 5,
    GameInputSwitchDownLeft  = 6,
    GameInputSwitchLeft      = 7,
    GameInputSwitchUpLeft    = 8
};
```

## Constants

| Constant | Description |
| - | - |
| GameInputSwitchCenter | Switch in the center position. |
| GameInputSwitchUp | Switch in the up position. |
| GameInputSwitchUpRight | Switch in the up-right position. |
| GameInputSwitchRight | Switch in the right position. |
| GameInputSwitchDownRight | Switch in the down-right position. |
| GameInputSwitchDown | Switch in the down position. |
| GameInputSwitchDownLeft | Switch in the down-left position. |
| GameInputSwitchLeft | Switch in the left position. |
| GameInputSwitchUpLeft | Switch in the up-left position. |

## Remarks

Not every switch supports each value.

This enumeration is used in the [GameInputFlightStickState](https://docs.xbox.com/reference/input/gameinput/structs/gameinputflightstickstate.md) structure and the [IGameInputReading::GetControllerSwitchState](https://docs.xbox.com/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrollerswitchstate.md) method.

For intermediate and advanced use cases of the GameInput API, see [Advanced GameInput](https://docs.xbox.com/build/core-features/common/input/advanced/input-advanced-topics.md) topics.

## 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

- [GameInputButtonMapping](https://docs.xbox.com/reference/input/gameinput/structs/gameinputbuttonmapping.md)
- [GameInputFlightStickState](https://docs.xbox.com/reference/input/gameinput/structs/gameinputflightstickstate.md)
- [GetControllerAxisState](https://docs.xbox.com/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getcontrolleraxisstate.md)
- [GameInputAxisMapping](https://docs.xbox.com/reference/input/gameinput/structs/gameinputaxismapping.md)
- [GameInput API members](https://docs.xbox.com/reference/input/gameinput/gameinput_members.md)
