> ## 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（已弃用）

> 检索输入设备的当前状态（已在 v4 中移除）。

> [!WARNING]
>
> **已弃用。** 此方法已在 GameInput v4 中移除，当前 API 中不再提供。请使用 [IGameInputDevice::IsConnected](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_isconnected.md) 检查设备是否已连接，并在设备回调中处理 [GameInputDeviceEvent](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/enums/gameinputdeviceevent) 值以响应变化。

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

## 语法

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

### 参数

此方法没有参数。

### 返回值

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

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

## 备注

返回的 [GameInputDeviceStatus](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/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 API 成员](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)\
[IGameInputDevice::IsConnected](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_isconnected.md)\
[GameInputDeviceEvent](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/enums/gameinputdeviceevent)\
[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/deprecated/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)

## 版本历史

| 版本 | 变更 |
| - | - |
| **v4** | 已移除。 |
| **v0** | 引入。 |


## Related topics

- [GameInputDeviceStatus（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/enums/gameinputdevicestatus.md)
- [GetDeviceStatus](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdevicestatus.md)
- [GetDeviceInfo（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceinfo.md)
- [IGameInputDevice::GetRawDeviceFeature（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getrawdevicefeature.md)
- [IGameInputDevice::GetBatteryState（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getbatterystate.md)