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

> IGameInput::RegisterGuideButtonCallback

# IGameInput::RegisterGuideButtonCallback

<Warning>**사용되지 않음.** 이 메서드는 GameInput v1에서 제거되었으며 현재 API에서는 사용할 수 없습니다. 대신 [RegisterSystemButtonCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback)을 사용하세요.</Warning>

Guide 버튼이 눌리거나 해제될 때 호출될 콜백 함수를 등록합니다.

## 구문

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

### 매개변수

*device*   \_In\_opt\_\
형식: IGameInputDevice\*

등록된 콜백을 특정 디바이스로 제한합니다.

*context*   \_In\_opt\_\
형식: void\*

콜백 함수에 전달되는 타이틀 정의 컨텍스트입니다.

*callbackFunc*   \_In\_\
형식: [GameInputGuidButtonCallback](/reference/input/gameinput/deprecated/functions/gameinputguidebuttoncallback)\*

등록할 타이틀 정의 콜백 함수입니다.

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

등록된 콜백을 식별하는 토큰입니다.

### 반환값

형식: HRESULT

함수 결과입니다.

## 설명

이 메서드는 [RegisterSystemButtonCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback)으로 대체되었으며, 이는 [GameInputSystemButtonCallback](/reference/input/gameinput/functions/gameinputsystembuttoncallback) 콜백 유형을 통해 Guide 및 Share 버튼 이벤트를 모두 처리합니다.

## 버전 기록

| 버전     | 변경 사항                                                                                                                                        |
| ------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| **v1** | 제거됨. [RegisterSystemButtonCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback)으로 대체됨. |
| **v0** | 도입됨.                                                                                                                                         |

## 함께 보기

[사용되지 않는 GameInput API 멤버](/reference/input/gameinput/deprecated/gameinput_deprecated_members)\
[IGameInput::RegisterSystemButtonCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback)\
[GameInputGuidButtonCallback](/reference/input/gameinput/deprecated/functions/gameinputguidebuttoncallback)\
[IGameInput](/reference/input/gameinput/interfaces/igameinput/igameinput)


## Related topics

- [GameInputGuidButtonCallback](/ko/reference/input/gameinput/deprecated/functions/gameinputguidebuttoncallback.md)
- [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::RegisterKeyboardLayoutCallback](/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerkeyboardlayoutcallback.md)
- [사용되지 않는 GameInput API 멤버](/ko/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)