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

# GameInputGuidButtonCallback (已淘汰)

> GameInputGuidButtonCallback

# GameInputGuidButtonCallback

> [!WARNING]
>
> **已淘汰。** 此回呼類型已在 GameInput v1 中移除，目前的 API 中無法使用。請改用 [GameInputSystemButtonCallback](/zh-TW/reference/input/gameinput/functions/gameinputsystembuttoncallback)。

用於 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

如果按下 Guide 按鈕則為 `true`；如果放開則為 `false`。

## 備註

此回呼類型是透過 [IGameInput::RegisterGuideButtonCallback](/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_registerguidebuttoncallback) 註冊。兩者皆已在 v1 中移除，並由透過 [IGameInput::RegisterSystemButtonCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registersystembuttoncallback) 註冊的 [GameInputSystemButtonCallback](/zh-TW/reference/input/gameinput/functions/gameinputsystembuttoncallback) 取代，後者也涵蓋 Share 按鈕。

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **v1** | 已移除。由 [GameInputSystemButtonCallback](/zh-TW/reference/input/gameinput/functions/gameinputsystembuttoncallback) 取代。 |
| **v0** | 推出。 |

## 另請參閱

[已淘汰的 GameInput API 成員](/zh-TW/reference/input/gameinput/deprecated/gameinput_deprecated_members)
[IGameInput::RegisterGuideButtonCallback](/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_registerguidebuttoncallback)
[GameInputSystemButtonCallback](/zh-TW/reference/input/gameinput/functions/gameinputsystembuttoncallback)


## Related topics

- [IGameInput::RegisterGuideButtonCallback (已淘汰)](/zh-TW/reference/input/gameinput/deprecated/interfaces/igameinput/methods/igameinput_registerguidebuttoncallback.md)
- [GameInputControllerButtonInfo (已淘汰)](/zh-TW/reference/input/gameinput/deprecated/structs/gameinputcontrollerbuttoninfo.md)
- [GameInputUiNavigationButtons (已淘汰)](/zh-TW/reference/input/gameinput/deprecated/enums/gameinputuinavigationbuttons.md)
- [已淘汰的 GameInput API 成員](/zh-TW/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)
- [GameInputLocation (已淘汰)](/zh-TW/reference/input/gameinput/deprecated/enums/gameinputlocation.md)