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

# GameInputGuidButtonCallback（已弃用）

> GameInputGuidButtonCallback

# GameInputGuidButtonCallback

> [!WARNING]
>
> **已弃用。** 此回调类型已在 GameInput v1 中移除，当前 API 中不再提供。请改用 [GameInputSystemButtonCallback](https://docs.xbox.com/zh-CN/reference/input/gameinput/functions/gameinputsystembuttoncallback.md)。

用于 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](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_registerguidebuttoncallback.md) 注册。两者均已在 v1 中移除，并由通过 [IGameInput::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) 取代，后者还涵盖了 Share 按钮。

## 版本历史

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

## 另请参阅

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


## Related topics

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