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

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

## 語法

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

### 參數

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

由 [IGameInput::RegisterSystemButtonCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback) 傳回的回呼權杖。

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

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

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

觸發事件的裝置。

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

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

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

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

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

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

### 傳回值

類型：void

## 備註

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

## 需求

**標頭：** GameInput.h

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

## 版本歷程記錄

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


## Related topics

- [GameInputSystemButtonCallback](/zh-CN/reference/input/gameinput/functions/gameinputsystembuttoncallback.md)
- [GameInputGuidButtonCallback](/reference/input/gameinput/deprecated/functions/gameinputguidebuttoncallback.md)