> ## 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 una función a la que se llama cuando llega una nueva lectura a la secuencia de entrada.

## Sintaxis

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

### Parámetros

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

Limita la devolución de llamada registrada para que solo se desencadene para un dispositivo específico.

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

Limita la devolución de llamada registrada para que solo se desencadene para dispositivos que admitan al menos uno de los tipos de entrada especificados.

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

Un objeto que proporciona información relevante para la función de devolución de llamada. Normalmente, el objeto que realiza la llamada.

*callbackFunc*   \_In\_\\
Tipo: GameInputReadingCallback

Función de devolución de llamada definida por el título.

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

Token que identifica la función de devolución de llamada registrada. Este token se usará para identificar la función registrada en caso de que quiera cancelar o anular el registro de la función de devolución de llamada.

### Valor devuelto

Tipo: HRESULT

Resultado de la función.

## Comentarios

Registrar una devolución de llamada no hace que se envíe una devolución de llamada inicial con la lectura más actual que coincida con el filtro de entrada proporcionado. Solo hace que se envíen devoluciones de llamada para los cambios de estado posteriores.

## Requisitos

**Encabezado:** GameInput.h

[Información general de la API de entrada](/build/core-features/common/input/overviews/input-overview)\
[IGameInput](/reference/input/gameinput/interfaces/igameinput/igameinput)\
[IGameInput::UnregisterCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_unregistercallback)\
[IGameInput::StopCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_stopcallback)

## Historial de versiones

| Versión | Cambios       |
| ------- | ------------- |
| **v0**  | Se introdujo. |


## Related topics

- [GameInputReadingCallback](/es/reference/input/gameinput/functions/gameinputreadingcallback.md)
- [IGameInput::StopCallback](/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_stopcallback.md)
- [IGameInput::FindDeviceFromId](/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_finddevicefromid.md)
- [IGameInput::UnregisterCallback](/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_unregistercallback.md)
- [IGameInput::RegisterDeviceCallback](/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)