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

# 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](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback) 返回的回调令牌。

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

传递给 [IGameInput::RegisterSystemButtonCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback) 的由游戏标题定义的上下文。

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

触发事件的设备。

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

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

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

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

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

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

### 返回值

类型：void

## 备注

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

## 要求

**标头：** GameInput.h

[GameInput 概述](/build/core-features/common/input/overviews/input-overview)\
[GameInput](/reference/input/gameinput/gameinput_members)

## 版本历史

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


## Related topics

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