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

# GameInputKeyboardLayoutCallback

> GameInputKeyboardLayoutCallback

# GameInputKeyboardLayoutCallback

Retorno de chamada definido pelo título para o evento do botão Guia (pressionado ou liberado).

## Sintaxe

```cpp theme={null}
void GameInputKeyboardLayoutCallback(
    GameInputCallbackToken callbackToken,
    void * context,
    IGameInputDevice * device,
    uint64_t timestamp,
    uint32_t currentLayout,
    uint32_t previousLayout
);
```

### Parâmetros

*callbackToken*   \_In\_\
Tipo: GameInputCallbackToken

O token de retorno de chamada retornado por [IGameInput::RegisterKeyboardLayoutCallback](/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerkeyboardlayoutcallback).

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

O contexto definido pelo título passado para [IGameInput::RegisterKeyboardLayoutCallback](/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerkeyboardlayoutcallback).

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

O dispositivo que disparou o evento.

*timestamp*   \_In\_\
Tipo: uint64\_t

O carimbo de data/hora em microssegundos associado ao evento.

*currentLayout*   \_In\_\
Tipo: uint32\_t

O layout de teclado novo/atual.

*previousLayout*   \_In\_\
Tipo: uint32\_t

O layout de teclado anterior.

### Valor retornado

Tipo: void

## Comentários

A função `GameInputKeyboardLayoutCallback` é usada pelo retorno de chamada definido pelo título quando o layout do teclado é alterado. Ela é registrada com o método [IGameInput::RegisterKeyboardLayoutCallback](/pt-BR/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerkeyboardlayoutcallback). Essa função é disparada pelas condições definidas no método de registro. Para obter mais informações, confira [Tópicos avançados do GameInput](/pt-BR/build/core-features/common/input/advanced/input-advanced-topics).

Os parâmetros `currentLayout` e `previousLayout` contêm os valores de ID de layout de teclado idênticos aos fornecidos pela função [GetKeyboardLayoutName](https://learn.microsoft.com/windows/win32/api/winuser/nf-winuser-getkeyboardlayoutnamea), mas expressos como um inteiro de 32 bits em vez de uma cadeia de caracteres.

## Requisitos

**Cabeçalho:** GameInput.h

**Biblioteca:** gameinput.lib

**Plataformas com suporte:** Windows, consoles da família XBOX One e consoles XBOX Series

## Confira também

[Visão geral do GameInput](/pt-BR/build/core-features/common/input/overviews/input-overview)<br />
[GameInput](/pt-BR/reference/input/gameinput/gameinput_members)

## Histórico de versões

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


## Related topics

- [GameInputKeyboardLayoutCallback](/reference/input/gameinput/functions/gameinputkeyboardlayoutcallback.md)
- [IGameInput::RegisterKeyboardLayoutCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerkeyboardlayoutcallback.md)
- [GameInput](/reference/input/gameinput/gameinput_members.md)