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

# IGameInputReading::GetTouchState

> IGameInputReading::GetTouchState

# IGameInputReading::GetTouchState

<Warning>**Deprecated.** This method was removed in GameInput v1 and is not available in the current API. This method was never implemented on PC.</Warning>

Gets the touch input state for all active contacts in the reading.

## Syntax

```cpp theme={null}
uint32_t GetTouchState(
    uint32_t stateArrayCount,
    GameInputTouchState* stateArray
);
```

### Parameters

*stateArrayCount*   \_In\_\
Type: uint32\_t

The number of elements in the `stateArray`.

*stateArray*   \_Out\_writes\_(stateArrayCount)\_\
Type: [GameInputTouchState](/reference/input/gameinput/deprecated/structs/gameinputtouchstate)\*

An array of [GameInputTouchState](/reference/input/gameinput/deprecated/structs/gameinputtouchstate) structures to fill with touch contact data.

### Return value

Type: uint32\_t

The number of [GameInputTouchState](/reference/input/gameinput/deprecated/structs/gameinputtouchstate) entries written to `stateArray`.

## Remarks

This method was removed in v1. Call [GetTouchCount](/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_gettouchcount) first to determine the required array size, then call `GetTouchState` with an appropriately sized array.

## Version History

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

## See also

[Deprecated GameInput API members](/reference/input/gameinput/deprecated/gameinput_deprecated_members)\
[IGameInputReading::GetTouchCount](/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_gettouchcount)\
[GameInputTouchState](/reference/input/gameinput/deprecated/structs/gameinputtouchstate)\
[IGameInputReading](/reference/input/gameinput/interfaces/igameinputreading/igameinputreading)


## Related topics

- [IGameInputReading::GetTouchCount](/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_gettouchcount.md)
- [GameInputTouchState](/reference/input/gameinput/deprecated/structs/gameinputtouchstate.md)
- [Build a native touch interface with IGameInput](/build/core-features/common/game-streaming/game-streaming-native-touch-igameinput.md)
- [IGameInputReading::GetGamepadState](/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getgamepadstate.md)
- [IGameInputReading::GetSensorsState](/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getsensorsstate.md)