> ## 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](/reference/input/gameinput/enums/gameinputdevicestatus)

返回的值是枚举类型 `GameInputDeviceStatus`。返回的值可能是来自 [GameInputDeviceStatus](/reference/input/gameinput/enums/gameinputdevicestatus) 的枚举标志值的组合。

## 注解

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

## 要求

**头文件:** GameInput.h

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

## 版本历史

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


## Related topics

- [GameInputDeviceStatus](/zh-CN/reference/input/gameinput/enums/gameinputdevicestatus.md)
- [GameInputDeviceCallback](/zh-CN/reference/input/gameinput/functions/gameinputdevicecallback.md)
- [PFAccountManagementClientLinkIOSDeviceIDAsync](/zh-CN/services/playfab/api-references/c/pfaccountmanagement/functions/pfaccountmanagementclientlinkiosdeviceidasync.md)
- [PFAccountManagementClientUnlinkIOSDeviceIDAsync](/zh-CN/services/playfab/api-references/c/pfaccountmanagement/functions/pfaccountmanagementclientunlinkiosdeviceidasync.md)
- [PFAccountManagementClientLinkAndroidDeviceIDAsync](/zh-CN/services/playfab/api-references/c/pfaccountmanagement/functions/pfaccountmanagementclientlinkandroiddeviceidasync.md)