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

> IGameInput::RegisterGuideButtonCallback

# IGameInput::RegisterGuideButtonCallback

> [!WARNING]
>
> **已淘汰。** 此方法已在 GameInput v1 中移除，目前的 API 中無法使用。請改用 [RegisterSystemButtonCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback.md)。

註冊在按下或放開 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](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/functions/gameinputguidebuttoncallback.md)\*

要註冊、由遊戲定義的回呼函式。

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

識別已註冊回呼的權杖。

### 傳回值

類型：HRESULT

函式結果。

## 備註

此方法已由 [RegisterSystemButtonCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback.md) 取代，後者會透過 [GameInputSystemButtonCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/functions/gameinputsystembuttoncallback.md) 回呼類型同時處理 Guide 和 Share 按鈕事件。

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **v1** | 已移除。由 [RegisterSystemButtonCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback.md) 取代。 |
| **v0** | 推出。 |

## 另請參閱

[已淘汰的 GameInput API 成員](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)\
[IGameInput::RegisterSystemButtonCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback.md)\
[GameInputGuidButtonCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/functions/gameinputguidebuttoncallback.md)\
[IGameInput](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/igameinput.md)


## Related topics

- [GameInputGuidButtonCallback (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/functions/gameinputguidebuttoncallback.md)
- [RegisterSystemButtonCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback.md)
- [已淘汰的 GameInput API 成員](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)
- [IGameInput (介面內容)](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/igameinput.md)
- [GameInputControllerButtonInfo (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/structs/gameinputcontrollerbuttoninfo.md)