> ## 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/ko/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/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_unregistercallback.md) 및 [IGameInput::StopCallback](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/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/deprecated/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 API 멤버](https://docs.xbox.com/ko/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/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getkeyboardinfo.md)\
[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)

## 버전 기록

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


## Related topics

- [IGameInput::StopCallback (사용되지 않음)](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_stopcallback.md)
- [IGameInput::RegisterKeyboardLayoutCallback](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerkeyboardlayoutcallback.md)
- [IGameInput::RegisterGuideButtonCallback (사용되지 않음)](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_registerguidebuttoncallback.md)
- [GameInputGuidButtonCallback (사용되지 않음)](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/functions/gameinputguidebuttoncallback.md)
- [IGameInput::FindDeviceFromObject (사용되지 않음)](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_finddevicefromobject.md)