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

# GameInputReadingCallback

> GameInputReadingCallback

# GameInputReadingCallback

用于新读数到达事件的、由游戏标题定义的回调。

## 语法

```cpp theme={null}
void GameInputReadingCallback(
    GameInputCallbackToken callbackToken,
    void* context,
    IGameInputReading* reading
);
```

### 参数

*callbackToken*   \_In\_\
类型：GameInputCallbackToken

用于标识回调的回调令牌。
由 [IGameInput::RegisterReadingCallback](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerreadingcallback.md) 返回的令牌。

*context*   \_In\_\
类型：void\*

由游戏标题定义的上下文。

*reading*   \_In\_\
类型：IGameInputReading\*

新的读数。

### 返回值

类型：void

## 备注

此函数的定义由开发人员决定，但该函数的参数必须与之匹配，才能发生回调。此函数用于定义通过 [IGameInput::RegisterReadingCallback](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerreadingcallback.md) 注册的 GameInput 读数回调。它将定义每当从输入设备接收到所需读数时调用的函数。

## 要求

**标头：** GameInput.h

[输入 API 概述](https://docs.xbox.com/zh-CN/build/core-features/common/input/overviews/input-overview.md)\
[GameInput](https://docs.xbox.com/zh-CN/reference/input/gameinput/gameinput_members.md)\
[IGameInput::RegisterReadingCallback](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerreadingcallback.md)

## 版本历史

| 版本 | 变更 |
| - | - |
| **v1** | 移除了 `hasOverrunOccurred` 参数。 |
| **v0** | 引入。 |


## Related topics

- [IGameInput::RegisterReadingCallback](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerreadingcallback.md)
- [GameInput API 成员](https://docs.xbox.com/zh-CN/reference/input/gameinput/gameinput_members.md)
- [IGameInput::StopCallback](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinput/methods/igameinput_stopcallback.md)
- [IGameInput::UnregisterCallback](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinput/methods/igameinput_unregistercallback.md)
- [IGameInput::GetNextReading](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinput/methods/igameinput_getnextreading.md)