> ## 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](/reference/input/gameinput/functions/gameinputkeyboardlayoutcallback)

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

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

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

### 반환값

형식: HRESULT

함수 결과.

## 설명

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

## 요구 사항

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

**헤더:** GameInput.h

[GameInput 개요](/build/core-features/common/input/overviews/input-overview)\
[IGameInput](/reference/input/gameinput/interfaces/igameinput/igameinput)

## 버전 기록

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


## Related topics

- [IGameInput::RegisterDeviceCallback](/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)
- [IGameInput::RegisterReadingCallback](/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerreadingcallback.md)
- [IGameInput::RegisterGuideButtonCallback](/ko/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_registerguidebuttoncallback.md)
- [GameInput](/ko/reference/input/gameinput/gameinput_members.md)
- [IGameInput::StopCallback](/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_stopcallback.md)