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

# IGameInput::RegisterReadingCallback

> IGameInput::RegisterReadingCallback

# IGameInput::RegisterReadingCallback

Registra uma função a ser chamada quando uma nova leitura chega ao fluxo de entrada.

## Sintaxe

```cpp theme={null}
HRESULT RegisterReadingCallback(
    IGameInputDevice* device,
    GameInputKind inputKind,
    void* context,
    GameInputReadingCallback callbackFunc,
    GameInputCallbackToken* callbackToken
);
```

### Parâmetros

*device*   \_In\_opt\_\
Tipo: IGameInputDevice\*

Limita o retorno de chamada registrado para ser disparado somente para um dispositivo específico.

*inputKind*   \_In\_\
Tipo: [GameInputKind](/pt-BR/reference/input/gameinput/enums/gameinputkind)

Limita o retorno de chamada registrado para ser disparado somente para dispositivos que dão suporte a pelo menos um dos tipos de entrada especificados.

*context*   \_In\_opt\_\
Tipo: void\*

Algum objeto que fornece informações relevantes para a função de retorno de chamada. Normalmente, o objeto chamador.

*callbackFunc*   \_In\_\
Tipo: GameInputReadingCallback

Função de retorno de chamada definida pelo título.

*callbackToken*   \_Result\_zeroonfailure\_\
Tipo: GameInputCallbackToken\*

Token que identifica a função de retorno de chamada registrada. Esse token será usado para identificar a função registrada caso você queira cancelar ou cancelar o registro da função de retorno de chamada.

### Valor retornado

Tipo: HRESULT

Resultado da função.

## Comentários

O registro de um retorno de chamada não faz com que um retorno de chamada inicial seja despachado com a leitura mais atual que corresponde ao filtro de entrada fornecido. Ele apenas faz com que retornos de chamada sejam despachados para alterações de estado subsequentes.

## Requisitos

**Cabeçalho:** GameInput.h

[Visão geral da API de entrada](/pt-BR/build/core-features/common/input/overviews/input-overview)\
[IGameInput](/pt-BR/reference/input/gameinput/interfaces/igameinput/igameinput)\
[IGameInput::UnregisterCallback](/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_unregistercallback)\
[IGameInput::StopCallback](/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_stopcallback)

## Histórico de versões

| Versão | Alterações |
| - | - |
| **v0** | Introduzido. |


## Related topics

- [IGameInput::RegisterReadingCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerreadingcallback.md)
- [GameInputReadingCallback](/reference/input/gameinput/functions/gameinputreadingcallback.md)
- [IGameInput::StopCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_stopcallback.md)