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

# GameInputSystemButtonCallback

> GameInputSystemButtonCallback

# GameInputSystemButtonCallback

当 Guide 或 Share 按钮被按下或释放时调用的由游戏标题定义的回调。

## 语法

```cpp theme={null}
void GameInputSystemButtonCallback(
    GameInputCallbackToken callbackToken,
    void* context,
    IGameInputDevice* device,
    uint64_t timestamp,
    GameInputSystemButtons currentButtons,
    GameInputSystemButtons previousButtons
);
```

### 参数

*callbackToken*   \_In\_\
类型：GameInputCallbackToken

由 [IGameInput::RegisterSystemButtonCallback](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback.md) 返回的回调令牌。

*context*   \_In\_\
类型：void\*

传递给 [IGameInput::RegisterSystemButtonCallback](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback.md) 的由游戏标题定义的上下文。

*device*   \_In\_\
类型：IGameInputDevice\*

触发事件的设备。

*timestamp*   \_In\_\
类型：uint64\_t

与事件关联的微秒时间戳。

*currentButtons*   \_In\_\
类型：GameInputSystemButtons

当前已按下的系统按钮集。

*previousButtons*   \_In\_\
类型：GameInputSystemButtons

此次变化之前已按下的系统按钮集。

### 返回值

类型：void

## 备注

`GameInputSystemButtonCallback` 函数是由游戏标题定义的、用于 Guide 或 Share 按钮（按下或释放）事件的回调。它通过 [IGameInput::RegisterSystemButtonCallback](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback.md) 方法进行注册。此函数由注册方法中设置的条件触发。有关详细信息，请参阅 [IGameInput::RegisterSystemButtonCallback](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback.md)。

## 要求

**标头：** GameInput.h

[GameInput 概述](https://docs.xbox.com/zh-CN/build/core-features/common/input/overviews/input-overview.md)\
[GameInput](https://docs.xbox.com/zh-CN/reference/input/gameinput/gameinput_members.md)

## 版本历史

| 版本 | 变更 |
| - | - |
| **v1** | 将 `currentState` 和 `previousState` 参数重命名为 `currentButtons` 和 `previousButtons`。 |
| **v0** | 引入。 |


## Related topics

- [GameInputGuidButtonCallback（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/functions/gameinputguidebuttoncallback.md)
- [IGameInput::RegisterGuideButtonCallback（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_registerguidebuttoncallback.md)
- [GameInput API 成员](https://docs.xbox.com/zh-CN/reference/input/gameinput/gameinput_members.md)
- [已弃用的 GameInput API 成员](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)
- [IGameInput::StopCallback](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinput/methods/igameinput_stopcallback.md)