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

# IGameInput::RegisterKeyboardLayoutCallback (en desuso)

> Registra una función de devolución de llamada para cuando cambia una distribución de teclado (se quitó en v4).

> [!WARNING]
>
> **En desuso.** Este método se quitó en GameInput v4 y no está disponible en la API actual. En su lugar, controle el [evento de dispositivo](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/enums/gameinputdeviceevent) `GameInputDeviceEventKeyboardLayoutUpdated` y llame a [IGameInputDevice::GetKeyboardInfo](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getkeyboardinfo.md) para obtener la nueva distribución.

Registra una función de devolución de llamada para cuando cambia una distribución de teclado.

## Sintaxis

```cpp theme={null}
HRESULT RegisterKeyboardLayoutCallback(
    IGameInputDevice* device,
    void* context,
    GameInputKeyboardLayoutCallback callbackFunc,
    GameInputCallbackToken* callbackToken
);
```

### Parámetros

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

Opcionalmente, limita la devolución de llamada registrada para que se desencadene con un dispositivo específico.

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

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

*callbackFunc*   \_In\_\
Tipo: [GameInputKeyboardLayoutCallback](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/deprecated/functions/gameinputkeyboardlayoutcallback)

Función de devolución de llamada definida por el título a la que se llama cuando cambia la distribución del teclado.

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

Token que identifica la función de devolución de llamada registrada. Este token se usa para identificar la función registrada si necesita cancelar o anular el registro de la función de devolución de llamada.

### Valor devuelto

Tipo: HRESULT

Resultado de la función.

## Comentarios

El método `RegisterKeyboardLayoutCallback` registra una función de devolución de llamada para cuando cambia una distribución de teclado. Para obtener información relacionada, consulte los métodos [IGameInput::UnregisterCallback](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_unregistercallback.md) e [IGameInput::StopCallback](https://docs.xbox.com/es/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_stopcallback.md). Para ver casos de uso intermedios y avanzados de la API de GameInput, consulte [Temas avanzados de GameInput](https://docs.xbox.com/es/build/core-features/common/input/advanced/input-advanced-topics.md).

## Requisitos

El método `RegisterKeyboardLayoutCallback` registra una función de devolución de llamada para cuando cambia una distribución de teclado. Para obtener información relacionada, consulte los métodos [IGameInput::UnregisterCallback](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_unregistercallback.md) e [IGameInput::StopCallback](https://docs.xbox.com/es/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_stopcallback.md). Para ver casos de uso intermedios y avanzados de la API de GameInput, consulte [Temas avanzados de GameInput](https://docs.xbox.com/es/build/core-features/common/input/advanced/input-advanced-topics.md).

**Encabezado:** GameInput.h

## Consulte también

[Miembros de la API de GameInput en desuso](https://docs.xbox.com/es/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)\
[GameInputDeviceEvent](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/enums/gameinputdeviceevent)\
[IGameInputDevice::GetKeyboardInfo](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getkeyboardinfo.md)\
[Información general de GameInput](https://docs.xbox.com/es/build/core-features/common/input/overviews/input-overview.md)\
[IGameInput](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinput/igameinput.md)

## Historial de versiones

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


## Related topics

- [IGameInput::RegisterKeyboardLayoutCallback](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerkeyboardlayoutcallback.md)
- [IGameInput::StopCallback (en desuso)](https://docs.xbox.com/es/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_stopcallback.md)
- [IGameInput::RegisterGuideButtonCallback (en desuso)](https://docs.xbox.com/es/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_registerguidebuttoncallback.md)
- [Miembros de la API de GameInput en desuso](https://docs.xbox.com/es/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)
- [IGameInput (Contenido de la interfaz)](https://docs.xbox.com/es/reference/input/gameinput/interfaces/igameinput/igameinput.md)