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

Title defined callback for the new reading arrived event.

## Syntax

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

### Parameters

*callbackToken*   \_In\_\
Type: GameInputCallbackToken

The callback token identifying the callback.
Token returned by [IGameInput::RegisterReadingCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerreadingcallback).

*context*   \_In\_\
Type: void\*

Title defined context.

*reading*   \_In\_\
Type: IGameInputReading\*

The new reading.

### Return value

Type: void

## Remarks

This function's definition is determined by the developer, but the parameters of that function must match in order for the callback to occur. This function is used to define the GameInput reading callback registered with [IGameInput::RegisterReadingCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerreadingcallback). It will define the function that is called whenever a desired reading is received from an input device.

## Requirements

**Header:** GameInput.h

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

## Version History

| Version | Changes                                 |
| ------- | --------------------------------------- |
| **v1**  | Removed `hasOverrunOccurred` parameter. |
| **v0**  | Introduced.                             |


## Related topics

- [IGameInput::RegisterReadingCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerreadingcallback.md)
- [GameInput](/reference/input/gameinput/gameinput_members.md)
- [GameInput callbacks](/build/core-features/common/input/advanced/input-callbacks.md)
- [GameInput readings](/build/core-features/common/input/overviews/input-readings.md)
- [IGameInput::StopCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_stopcallback.md)