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

> 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](https://docs.xbox.com/ko/reference/input/gameinput/functions/gameinputkeyboardlayoutcallback.md)

키보드 레이아웃이 변경될 때 호출되는 타이틀 정의 콜백 함수입니다.

*callbackToken*   \_Result\_zeroonfailure\_\
형식: GameInputCallbackToken\*

등록된 콜백 함수를 식별하는 토큰입니다. 이 토큰은 콜백 함수를 취소하거나 등록 해제해야 하는 경우 등록된 함수를 식별하는 데 사용됩니다.

### 반환값

형식: HRESULT

함수 결과.

## 설명

`RegisterKeyboardLayoutCallback` 메서드는 키보드 레이아웃이 변경될 때 호출되는 콜백 함수를 등록합니다. 관련 정보는 [IGameInput::UnregisterCallback](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_unregistercallback.md) 및 [IGameInput::StopCallback](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_stopcallback.md) 메서드를 참조하세요. GameInput API의 중급 및 고급 사용 사례는 [고급 GameInput 항목](https://docs.xbox.com/ko/build/core-features/common/input/advanced/input-advanced-topics.md)을 참조하세요.

## 요구 사항

`RegisterKeyboardLayoutCallback` 메서드는 키보드 레이아웃이 변경될 때 호출되는 콜백 함수를 등록합니다. 관련 정보는 [IGameInput::UnregisterCallback](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_unregistercallback.md) 및 [IGameInput::StopCallback](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_stopcallback.md) 메서드를 참조하세요. GameInput API의 중급 및 고급 사용 사례는 [고급 GameInput 항목](https://docs.xbox.com/ko/build/core-features/common/input/advanced/input-advanced-topics.md)을 참조하세요.

**헤더:** GameInput.h

[GameInput 개요](https://docs.xbox.com/ko/build/core-features/common/input/overviews/input-overview.md)\
[IGameInput](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinput/igameinput.md)

## 버전 기록

| 버전 | 변경 사항 |
| - | - |
| **v0** | 도입됨. |


## Related topics

- [GameInputKeyboardLayoutCallback](https://docs.xbox.com/ko/reference/input/gameinput/functions/gameinputkeyboardlayoutcallback.md)
- [IGameInput::RegisterDeviceCallback](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)
- [IGameInput::RegisterReadingCallback](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerreadingcallback.md)
- [IGameInput::RegisterGuideButtonCallback (사용되지 않음)](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_registerguidebuttoncallback.md)
- [RegisterSystemButtonCallback](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback.md)