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

# GetDeviceStatus

> GetDeviceStatus

# GetDeviceStatus

擷取輸入裝置目前的狀態。

## 語法

```cpp theme={null}
GameInputDeviceStatus GetDeviceStatus();
```

### 參數

此方法沒有參數。

### 傳回值

類型：[GameInputDeviceStatus](/zh-TW/reference/input/gameinput/enums/gameinputdevicestatus)

傳回的值是列舉類型 `GameInputDeviceStatus`。傳回的值可能是 [GameInputDeviceStatus](/zh-TW/reference/input/gameinput/enums/gameinputdevicestatus) 中列舉旗標值的組合。

## 備註

傳回的 [GameInputDeviceStatus](/zh-TW/reference/input/gameinput/enums/gameinputdevicestatus) 列舉會定義裝置是否已連線，以及遊戲與裝置之間可傳輸的輸入和輸出類型。如果在裝置已從系統中斷連線時呼叫 `GetDeviceStatus` 方法，則會傳回 `GameInputDeviceNoStatus` 值。您可以將 `GameInputDeviceStatus` 列舉當作 [RegisterDeviceCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback) 方法的篩選條件，以回應裝置狀態的特定變更。

## 需求

**標頭：** GameInput.h

[GameInput 概觀](/zh-TW/build/core-features/common/input/overviews/input-overview)\
[GameInputDeviceStatus](/zh-TW/reference/input/gameinput/enums/gameinputdevicestatus)\
[RegisterDeviceCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback)\
[IGameInputDevice](/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice)

## 版本歷程記錄

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


## Related topics

- [GameInputDeviceStatus](/zh-TW/reference/input/gameinput/enums/gameinputdevicestatus.md)
- [IGameInputDevice](/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)
- [Get Play Fab IDs From Nintendo Switch Device Ids](/api-reference/account-management/get-play-fab-ids-from-nintendo-switch-device-ids.md)
- [GetHapticInfo](/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_gethapticinfo.md)
- [Report Device Info](/api-reference/analytics/report-device-info.md)