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

由遊戲定義、用於指南按鈕 (按下或放開) 事件的回呼。

## 語法

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

### 參數

*callbackToken*   \_In\_\
類型：GameInputCallbackToken

由 [IGameInput::RegisterKeyboardLayoutCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerkeyboardlayoutcallback) 傳回的回呼權杖。

*context*   \_In\_\
類型：void\*

傳遞給 [IGameInput::RegisterKeyboardLayoutCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerkeyboardlayoutcallback) 的遊戲定義內容。

*device*   \_In\_\
類型：IGameInputDevice\*

觸發事件的裝置。

*timestamp*   \_In\_\
類型：uint64\_t

與事件關聯的微秒時間戳記。

*currentLayout*   \_In\_\
類型：uint32\_t

新的/目前的鍵盤配置。

*previousLayout*   \_In\_\
類型：uint32\_t

先前的鍵盤配置。

### 傳回值

類型：void

## 備註

`GameInputKeyboardLayoutCallback` 函式由遊戲定義的回呼在鍵盤配置變更時使用。它會透過 [IGameInput::RegisterKeyboardLayoutCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerkeyboardlayoutcallback) 方法註冊。此函式會由註冊方法所設定的條件觸發。如需詳細資訊，請參閱 [進階 GameInput 主題](/zh-TW/build/core-features/common/input/advanced/input-advanced-topics)。

`currentLayout` 和 `previousLayout` 參數包含鍵盤配置識別碼值，這些值與 [GetKeyboardLayoutName](https://learn.microsoft.com/windows/win32/api/winuser/nf-winuser-getkeyboardlayoutnamea) 函式所提供的值相同，但以 32 位元整數而非字串表示。

## 需求

**標頭：** GameInput.h

**程式庫：** gameinput.lib

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[GameInput 概觀](/zh-TW/build/core-features/common/input/overviews/input-overview)<br />
[GameInput](/zh-TW/reference/input/gameinput/gameinput_members)

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **v0** | 已推出。 |


## Related topics

- [IGameInput::RegisterKeyboardLayoutCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerkeyboardlayoutcallback.md)
- [GameInput](/zh-TW/reference/input/gameinput/gameinput_members.md)
- [GameInputKeyboardInfo](/zh-TW/reference/input/gameinput/structs/gameinputkeyboardinfo.md)
- [GameInputKeyboardKind](/zh-TW/reference/input/gameinput/enums/gameinputkeyboardkind.md)
- [IGameInput](/zh-TW/reference/input/gameinput/interfaces/igameinput/igameinput.md)