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

# GameInputDeviceCallback

> GameInputDeviceCallback

# GameInputDeviceCallback

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

## 語法

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

### 參數

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

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

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

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

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

觸發回呼的裝置。

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

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

*currentStatus*   \_In\_\
類型：[GameInputDeviceStatus](/zh-TW/reference/input/gameinput/enums/gameinputdevicestatus)

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

*previousStatus*   \_In\_\
類型：[GameInputDeviceStatus](/zh-TW/reference/input/gameinput/enums/gameinputdevicestatus)

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

### 傳回值

[輸入 API 概觀](/zh-TW/build/core-features/common/input/overviews/input-overview)\
[GameInput](/zh-TW/reference/input/gameinput/gameinput_members)\
[IGameInput::RegisterDeviceCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback)

## 版本歷程記錄

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


## Related topics

- [GameInputDeviceCallback](/zh-CN/reference/input/gameinput/functions/gameinputdevicecallback.md)
- [IGameInput::RegisterDeviceCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)
- [GameInput](/reference/input/gameinput/gameinput_members.md)