> ## 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](/zh-CN/reference/input/gameinput/deprecated/functions/gameinputguidebuttoncallback.md)
- [IGameInput::RegisterReadingCallback](/zh-CN/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerreadingcallback.md)
- [IGameInput::RegisterDeviceCallback](/zh-CN/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)
- [IGameInput::RegisterKeyboardLayoutCallback](/zh-CN/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerkeyboardlayoutcallback.md)
- [已弃用的 GameInput API 成员](/zh-CN/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)