> ## 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.

# GameInputGuidButtonCallback

> GameInputGuidButtonCallback

# GameInputGuidButtonCallback

<Warning>**已弃用。** 此回调类型已在 GameInput v1 中移除，当前 API 中不再提供。请改用 [GameInputSystemButtonCallback](/reference/input/gameinput/functions/gameinputsystembuttoncallback)。</Warning>

用于 Guide (XBOX) 按钮按下和释放通知的回调函数类型。

## 语法

```cpp theme={null}
typedef void GameInputGuidButtonCallback(
    GameInputCallbackToken callbackToken,
    void* context,
    IGameInputDevice* sender,
    uint64_t timestamp,
    bool isPressed
);
```

### 参数

*callbackToken*\
类型：GameInputCallbackToken

标识已注册回调的令牌。

*context*\
类型：void\*

注册回调时提供的、由标题定义的上下文值。

*sender*\
类型：IGameInputDevice\*

触发回调的设备。如果不针对特定设备，可以为 `nullptr`。

*timestamp*\
类型：uint64\_t

Guide 按钮事件发生的时间（以微秒为单位）。

*isPressed*\
类型：bool

`true` 表示 Guide 按钮被按下；`false` 表示释放。

## 备注

此回调类型通过 [IGameInput::RegisterGuideButtonCallback](/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_registerguidebuttoncallback) 注册。两者均已在 v1 中移除，并由通过 [IGameInput::RegisterSystemButtonCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback) 注册的 [GameInputSystemButtonCallback](/reference/input/gameinput/functions/gameinputsystembuttoncallback) 取代，后者还涵盖了 Share 按钮。

## 版本历史

| 版本     | 变更                                                                                                            |
| ------ | ------------------------------------------------------------------------------------------------------------- |
| **v1** | 已移除。由 [GameInputSystemButtonCallback](/reference/input/gameinput/functions/gameinputsystembuttoncallback) 取代。 |
| **v0** | 已引入。                                                                                                          |

## 另请参阅

[已弃用的 GameInput API 成员](/reference/input/gameinput/deprecated/gameinput_deprecated_members)
[IGameInput::RegisterGuideButtonCallback](/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_registerguidebuttoncallback)
[GameInputSystemButtonCallback](/reference/input/gameinput/functions/gameinputsystembuttoncallback)


## Related topics

- [IGameInput::RegisterGuideButtonCallback](/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_registerguidebuttoncallback.md)
- [已弃用的 GameInput API 成员](/zh-CN/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)
- [GameInputSystemButtonCallback](/zh-CN/reference/input/gameinput/functions/gameinputsystembuttoncallback.md)
- [GameInput](/zh-CN/reference/input/gameinput/gameinput_members.md)
- [IGameInput::StopCallback](/zh-CN/reference/input/gameinput/interfaces/igameinput/methods/igameinput_stopcallback.md)