> ## 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>**已弃用。** 此方法已在 GameInput v1 中移除，当前 API 中不再提供。此方法在 PC 上从未实现。</Warning>

获取读数中所有活动接触点的触摸输入状态。

## 语法

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

### 参数

*stateArrayCount*   \_In\_\
类型：uint32\_t

`stateArray` 中的元素数量。

*stateArray*   \_Out\_writes\_(stateArrayCount)\_\
类型：[GameInputTouchState](/reference/input/gameinput/deprecated/structs/gameinputtouchstate)\*

要用触摸接触数据填充的 [GameInputTouchState](/reference/input/gameinput/deprecated/structs/gameinputtouchstate) 结构数组。

### 返回值

类型：uint32\_t

写入 `stateArray` 的 [GameInputTouchState](/reference/input/gameinput/deprecated/structs/gameinputtouchstate) 项的数量。

## 备注

此方法已在 v1 中移除。首先调用 [GetTouchCount](/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_gettouchcount) 以确定所需的数组大小，然后使用大小合适的数组调用 `GetTouchState`。

## 版本历史

| 版本     | 变更   |
| ------ | ---- |
| **v1** | 已移除。 |
| **v0** | 已引入。 |

## 另请参阅

[已弃用的 GameInput API 成员](/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](/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_gettouchcount.md)
- [GameInputTouchState](/zh-CN/reference/input/gameinput/deprecated/structs/gameinputtouchstate.md)
- [IGameInputReading::GetGamepadState](/zh-CN/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getgamepadstate.md)
- [IGameInputReading::GetKeyState](/zh-CN/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getkeystate.md)
- [IGameInputReading::GetMouseState](/zh-CN/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getmousestate.md)