> ## 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 (已淘汰)

> 註冊在鍵盤配置變更時呼叫的回呼函式 (已在 v4 中移除)。

> [!WARNING]
>
> **已淘汰。** 此方法已在 GameInput v4 中移除，目前的 API 中無法使用。請改為處理 `GameInputDeviceEventKeyboardLayoutUpdated` [裝置事件](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/enums/gameinputdeviceevent)，並呼叫 [IGameInputDevice::GetKeyboardInfo](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getkeyboardinfo.md) 以取得新的配置。

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

## 語法

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

### 參數

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

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

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

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

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

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

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

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

### 傳回值

類型：HRESULT

函式結果。

## 備註

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

## 需求

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

**標頭：** GameInput.h

## 另請參閱

[已淘汰的 GameInput API 成員](https://docs.xbox.com/zh-TW/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/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getkeyboardinfo.md)\
[GameInput 概觀](https://docs.xbox.com/zh-TW/build/core-features/common/input/overviews/input-overview.md)\
[IGameInput](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/igameinput.md)

## 版本歷程記錄

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


## Related topics

- [IGameInput::RegisterKeyboardLayoutCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerkeyboardlayoutcallback.md)
- [IGameInput::StopCallback (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_stopcallback.md)
- [IGameInput::RegisterGuideButtonCallback (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_registerguidebuttoncallback.md)
- [已淘汰的 GameInput API 成員](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)
- [GameInputKeyboardLayoutCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/functions/gameinputkeyboardlayoutcallback.md)