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

# GameInputReadingCallback

> GameInputReadingCallback

# GameInputReadingCallback

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

## 语法

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

### 参数

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

用于标识回调的回调令牌。
由 [IGameInput::RegisterReadingCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerreadingcallback) 返回的令牌。

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

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

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

新的读数。

### 返回值

类型：void

## 备注

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

## 要求

**标头：** GameInput.h

[输入 API 概述](/build/core-features/common/input/overviews/input-overview)\
[GameInput](/reference/input/gameinput/gameinput_members)\
[IGameInput::RegisterReadingCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerreadingcallback)

## 版本历史

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


## Related topics

- [IGameInput::RegisterReadingCallback](/zh-CN/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerreadingcallback.md)
- [GameInput](/zh-CN/reference/input/gameinput/gameinput_members.md)
- [IGameInput::StopCallback](/zh-CN/reference/input/gameinput/interfaces/igameinput/methods/igameinput_stopcallback.md)
- [IGameInput::UnregisterCallback](/zh-CN/reference/input/gameinput/interfaces/igameinput/methods/igameinput_unregistercallback.md)
- [IGameInputReading::GetInputKind](/zh-CN/reference/input/gameinput/interfaces/igameinputreading/methods/igameinputreading_getinputkind.md)