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

# IGameInputReading::GetTouchState（已弃用）

> IGameInputReading::GetTouchState

# IGameInputReading::GetTouchState

> [!WARNING]
>
> **已弃用。** 此方法已在 GameInput v1 中移除，当前 API 中不再提供。此方法在 PC 上从未实现。

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

## 语法

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

### 参数

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

`stateArray` 中的元素数量。

*stateArray*   \_Out\_writes\_(stateArrayCount)\_\
类型：[GameInputTouchState](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/structs/gameinputtouchstate.md)\*

要用触摸接触数据填充的 [GameInputTouchState](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/structs/gameinputtouchstate.md) 结构数组。

### 返回值

类型：uint32\_t

写入 `stateArray` 的 [GameInputTouchState](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/structs/gameinputtouchstate.md) 项的数量。

## 备注

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

## 版本历史

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

## 另请参阅

[已弃用的 GameInput API 成员](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)\
[IGameInputReading::GetTouchCount](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_gettouchcount.md)\
[GameInputTouchState](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/structs/gameinputtouchstate.md)\
[IGameInputReading](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputreading/igameinputreading.md)


## Related topics

- [IGameInputReading::GetTouchCount（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_gettouchcount.md)
- [GameInputTouchState（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/structs/gameinputtouchstate.md)
- [IGameInputReading::GetMotionState（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_getmotionstate.md)
- [IGameInputReading::GetUiNavigationState（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinputreading/methods/igameinputreading_getuinavigationstate.md)
- [IGameInput::GetTemporalReading（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_gettemporalreading.md)