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

> IGameInput::RegisterKeyboardLayoutCallback

# IGameInput::RegisterKeyboardLayoutCallback

註冊在鍵盤配置變更時呼叫的回呼函式。

## 語法

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

### 參數

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

可選擇性地將已註冊的回呼限制為針對特定裝置觸發。

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

為回呼函式提供相關資訊的物件。通常是呼叫端物件。

*callbackFunc*   \_In\_\
類型：[GameInputKeyboardLayoutCallback](/zh-TW/reference/input/gameinput/functions/gameinputkeyboardlayoutcallback)

在鍵盤配置變更時呼叫的遊戲定義回呼函式。

*callbackToken*   \_Result\_zeroonfailure\_\
類型：GameInputCallbackToken\*

識別已註冊回呼函式的權杖。當您需要取消或取消註冊回呼函式時，會使用此權杖來識別已註冊的函式。

### 傳回值

類型：HRESULT

函式結果。

## 備註

`RegisterKeyboardLayoutCallback` 方法會註冊在鍵盤配置變更時呼叫的回呼函式。如需相關資訊，請參閱 [IGameInput::UnregisterCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_unregistercallback) 和 [IGameInput::StopCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_stopcallback) 方法。如需 GameInput API 的中階和進階使用案例，請參閱 [GameInput 進階主題](/zh-TW/build/core-features/common/input/advanced/input-advanced-topics)。

## 需求

`RegisterKeyboardLayoutCallback` 方法會註冊在鍵盤配置變更時呼叫的回呼函式。如需相關資訊，請參閱 [IGameInput::UnregisterCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_unregistercallback) 和 [IGameInput::StopCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_stopcallback) 方法。如需 GameInput API 的中階和進階使用案例，請參閱 [GameInput 進階主題](/zh-TW/build/core-features/common/input/advanced/input-advanced-topics)。

**標頭：** GameInput.h

[GameInput 概觀](/zh-TW/build/core-features/common/input/overviews/input-overview)\
[IGameInput](/zh-TW/reference/input/gameinput/interfaces/igameinput/igameinput)

## 版本歷程記錄

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


## Related topics

- [GameInputKeyboardLayoutCallback](/zh-TW/reference/input/gameinput/functions/gameinputkeyboardlayoutcallback.md)
- [IGameInput::RegisterDeviceCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)
- [IGameInput::RegisterReadingCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerreadingcallback.md)
- [IGameInput::RegisterSystemButtonCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback.md)
- [IGameInput::RegisterGuideButtonCallback](/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_registerguidebuttoncallback.md)