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

# GetDeviceStatus

> GetDeviceStatus

# GetDeviceStatus

检索输入设备的当前状态。

## 语法

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

### 参数

此方法没有参数。

### 返回值

类型:[GameInputDeviceStatus](https://docs.xbox.com/zh-CN/reference/input/gameinput/enums/gameinputdevicestatus.md)

返回的值是枚举类型 `GameInputDeviceStatus`。返回的值可能是来自 [GameInputDeviceStatus](https://docs.xbox.com/zh-CN/reference/input/gameinput/enums/gameinputdevicestatus.md) 的枚举标志值的组合。

## 注解

返回的 [GameInputDeviceStatus](https://docs.xbox.com/zh-CN/reference/input/gameinput/enums/gameinputdevicestatus.md) 枚举定义了设备是否已连接，以及游戏与设备之间可以传输的输入和输出类型。如果在设备已从系统断开连接时调用 `GetDeviceStatus` 方法，将返回 `GameInputDeviceNoStatus` 值。您可以将 `GameInputDeviceStatus` 枚举用作 [RegisterDeviceCallback](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md) 方法的过滤器，以对设备状态的特定变化作出响应。

## 要求

**头文件:** GameInput.h

[GameInput 概述](https://docs.xbox.com/zh-CN/build/core-features/common/input/overviews/input-overview.md)\
[GameInputDeviceStatus](https://docs.xbox.com/zh-CN/reference/input/gameinput/enums/gameinputdevicestatus.md)\
[RegisterDeviceCallback](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)\
[IGameInputDevice](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)

## 版本历史

| 版本 | 变更 |
| - | - |
| **v0** | 引入。 |


## Related topics

- [GameInputDeviceStatus](https://docs.xbox.com/zh-CN/reference/input/gameinput/enums/gameinputdevicestatus.md)
- [Get Play Fab IDs From Nintendo Switch Device Ids](https://docs.xbox.com/api-reference/account-management/get-play-fab-ids-from-nintendo-switch-device-ids.md)
- [Report Device Info](https://docs.xbox.com/api-reference/analytics/report-device-info.md)
- [GameInputDeviceCallback](https://docs.xbox.com/zh-CN/reference/input/gameinput/functions/gameinputdevicecallback.md)
- [Unlink Android Device ID](https://docs.xbox.com/api-reference/account-management/unlink-android-device-id.md)