> ## 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-CN/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-CN/reference/input/gameinput/deprecated/functions/gameinputguidebuttoncallback.md)\*

要注册的、由标题定义的回调函数。

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

标识已注册回调的令牌。

### 返回值

类型：HRESULT

函数结果。

## 备注

此方法已由 [RegisterSystemButtonCallback](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback.md) 取代，后者通过 [GameInputSystemButtonCallback](https://docs.xbox.com/zh-CN/reference/input/gameinput/functions/gameinputsystembuttoncallback.md) 回调类型同时处理 Guide 和 Share 按钮事件。

## 版本历史

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

## 另请参阅

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


## Related topics

- [GameInputGuidButtonCallback（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/functions/gameinputguidebuttoncallback.md)
- [已弃用的 GameInput API 成员](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)
- [GameInputUiNavigationButtons（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/enums/gameinputuinavigationbuttons.md)
- [GameInputControllerButtonInfo（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/structs/gameinputcontrollerbuttoninfo.md)
- [GameInputLocation（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/enums/gameinputlocation.md)