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

由遊戲定義的回呼，會在按下或放開指南或分享按鈕時呼叫。

## 語法

```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-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback.md) 傳回的回呼權杖。

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

傳遞給 [IGameInput::RegisterSystemButtonCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback.md) 的遊戲定義內容。

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

觸發事件的裝置。

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

與事件關聯的微秒時間戳記。

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

目前按下的系統按鈕集合。

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

此變更之前按下的系統按鈕集合。

### 傳回值

類型：void

## 備註

`GameInputSystemButtonCallback` 函式是由遊戲定義、用於指南或分享按鈕 (按下或放開) 事件的回呼。它會透過 [IGameInput::RegisterSystemButtonCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback.md) 方法註冊。此函式會由註冊方法所設定的條件觸發。如需詳細資訊，請參閱 [IGameInput::RegisterSystemButtonCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback.md)。

## 需求

**標頭：** GameInput.h

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

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **v1** | 已將 `currentState` 和 `previousState` 參數重新命名為 `currentButtons` 和 `previousButtons`。 |
| **v0** | 已推出。 |


## Related topics

- [GameInputGuidButtonCallback (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/functions/gameinputguidebuttoncallback.md)
- [IGameInput::RegisterGuideButtonCallback (已淘汰)](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_registerguidebuttoncallback.md)
- [RegisterSystemButtonCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback.md)
- [GameInput API 成員](https://docs.xbox.com/zh-TW/reference/input/gameinput/gameinput_members.md)
- [已淘汰的 GameInput API 成員](https://docs.xbox.com/zh-TW/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)