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

# GameInputDeviceStatus（已弃用）

> 枚举输入设备可能处于的状态（已在 v4 中移除）。

> [!WARNING]
>
> **已弃用。** 此枚举已在 GameInput v4 中移除，当前 API 中不再提供。请改用传递给设备回调的 [GameInputDeviceEvent](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/enums/gameinputdeviceevent) 值和 [IGameInputDevice::IsConnected](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_isconnected.md)。

枚举输入设备可能处于的状态。

## 语法

```cpp theme={null}
enum GameInputDeviceStatus
{
    GameInputDeviceNoStatus        = 0x00000000,
    GameInputDeviceConnected       = 0x00000001,
    GameInputDeviceHapticInfoReady = 0x00200000,
    GameInputDeviceAnyStatus       = 0xFFFFFFFF
};
```

## 常量

| 常量 | 说明 |
| - | - |
| GameInputDeviceNoStatus | 表示设备没有状态。 |
| GameInputDeviceConnected | 表示设备已连接。 |
| GameInputDeviceHapticInfoReady | 表示设备的触觉信息已就绪。 |
| GameInputDeviceAnyStatus | 对任何设备状态都会返回 true。 |

## 备注

这些标志值可以按需组合，以便同时对多个设备进行筛选。由 [iGameInputDevice\_GetDeviceStatus](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getdevicestatus.md) 返回。

应用程序可以通过 [IGameInput 接口](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinput/igameinput.md) 上的 [IGameInput::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)\
[GameInputDeviceEvent](https://learn.microsoft.com/en-us/gaming/gdk/docs/reference/input/gameinput/enums/gameinputdeviceevent)\
[IGameInputDevice::IsConnected](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_isconnected.md)\
[输入 API 概述](https://docs.xbox.com/zh-CN/build/core-features/common/input/overviews/input-overview.md)\
[GameInput](https://docs.xbox.com/zh-CN/reference/input/gameinput/gameinput_members.md)\
[IGameInput::RegisterDeviceCallback](https://docs.xbox.com/zh-CN/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)

## 版本历史

| 版本 | 变更 |
| - | - |
| **v4** | 已移除。 |
| **v2** | **新增** `GameInputDeviceHapticInfoReady` (0x00200000)。 |
| **v1** | **重大更改** — 移除了 8 个未使用的标志：`GameInputDeviceInputEnabled`、`GameInputDeviceOutputEnabled`、`GameInputDeviceRawIoEnabled`、`GameInputDeviceAudioCapture`、`GameInputDeviceAudioRender`、`GameInputDeviceSynchronized`、`GameInputDeviceWireless` 和 `GameInputDeviceUserIdle`。`GameInputDeviceAnyStatus` 的值由 `0x00FFFFFF` 更改为 `0xFFFFFFFF`。 |
| **v0** | 引入。 |

## 附录：以前的版本

### v0

```cpp theme={null}
enum GameInputDeviceStatus
{
    GameInputDeviceNoStatus       = 0x00000000,
    GameInputDeviceConnected      = 0x00000001,
    GameInputDeviceInputEnabled   = 0x00000002,
    GameInputDeviceOutputEnabled  = 0x00000004,
    GameInputDeviceRawIoEnabled   = 0x00000008,
    GameInputDeviceAudioCapture   = 0x00000010,
    GameInputDeviceAudioRender    = 0x00000020,
    GameInputDeviceSynchronized   = 0x00000040,
    GameInputDeviceWireless       = 0x00000080,
    GameInputDeviceUserIdle       = 0x00100000,
    GameInputDeviceAnyStatus      = 0x00FFFFFF
};
```

### v1

```cpp theme={null}
enum GameInputDeviceStatus
{
    GameInputDeviceNoStatus   = 0x00000000,
    GameInputDeviceConnected  = 0x00000001,
    GameInputDeviceAnyStatus  = 0xFFFFFFFF
};
```


## Related topics

- [GetDeviceStatus（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getdevicestatus.md)
- [已弃用的 GameInput API 成员](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)
- [GameInputBatteryState（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/structs/gameinputbatterystate.md)
- [GameInputDeviceStatus](https://docs.xbox.com/zh-CN/reference/input/gameinput/enums/gameinputdevicestatus.md)
- [GameInputDeviceInfo（已弃用）](https://docs.xbox.com/zh-CN/reference/input/gameinput/deprecated/structs/gameinputdeviceinfo.md)