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

# GameInputDeviceCallback

> GameInputDeviceCallback

# GameInputDeviceCallback

由遊戲定義、用於裝置連線和中斷連線事件的回呼。此函式會透過 [IGameInput::RegisterDeviceCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md) 註冊。此函式會由註冊函式所設定的條件觸發。

## 語法

```cpp theme={null}
void GameInputDeviceCallback(
    GameInputCallbackToken callbackToken,
    void* context,
    IGameInputDevice* device,
    uint64_t timestamp,
    GameInputDeviceStatus currentStatus,
    GameInputDeviceStatus previousStatus
);
```

### 參數

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

已註冊函式的回呼權杖。由 [IGameInput::RegisterDeviceCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md) 傳回的權杖。

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

傳遞給 [IGameInput::RegisterDeviceCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md) 的內容。

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

觸發回呼的裝置。

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

表示狀態變更發生時間的微秒時間戳記。

*currentStatus*   \_In\_\
類型：[GameInputDeviceStatus](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputdevicestatus.md)

裝置目前的連線和輸入狀態。

*previousStatus*   \_In\_\
類型：[GameInputDeviceStatus](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputdevicestatus.md)

裝置先前的連線和輸入狀態。

### 傳回值

[輸入 API 概觀](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)\
[IGameInput::RegisterDeviceCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **v0** | 已推出。 |


## Related topics

- [IGameInput::RegisterDeviceCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)
- [GameInput API 成員](https://docs.xbox.com/zh-TW/reference/input/gameinput/gameinput_members.md)
- [GameInputDeviceStatus](https://docs.xbox.com/zh-TW/reference/input/gameinput/enums/gameinputdevicestatus.md)
- [GameInputKeyboardLayoutCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/functions/gameinputkeyboardlayoutcallback.md)
- [GameInputSystemButtonCallback](https://docs.xbox.com/zh-TW/reference/input/gameinput/functions/gameinputsystembuttoncallback.md)