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

# GameInputDeviceStatus

> GameInputDeviceStatus

# GameInputDeviceStatus

輸入裝置可能處於之狀態的列舉。

## 語法

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

## 常數

| 常數 | 描述 |
| - | - |
| GameInputDeviceNoStatus | 表示裝置沒有狀態。 |
| GameInputDeviceConnected | 表示裝置已連接。 |
| GameInputDeviceHapticInfoReady | 表示裝置的觸覺資訊已就緒。 |
| GameInputDeviceAnyStatus | 對任何裝置狀態都會傳回 true。 |

## 備註

這些旗標值可依使用者需求組合，以一次篩選多個裝置。由 [iGameInputDevice\_GetDeviceStatus](/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdevicestatus) 傳回。

應用程式可以透過 [IGameInput 介面](/zh-TW/reference/input/gameinput/interfaces/igameinput/igameinput)上的 [IGameInput::RegisterDeviceCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback) 方法進行註冊，以便在這些狀態有任何變更時收到回呼。

## 需求

**標頭：** GameInput.h

[輸入 API 概觀](/zh-TW/build/core-features/common/input/overviews/input-overview)\
[GameInput](/zh-TW/reference/input/gameinput/gameinput_members)\
[IGameInput::RegisterDeviceCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback)

## 版本歷程記錄

| 版本 | 變更 |
| - | - |
| **v2** | **新增** `GameInputDeviceHapticInfoReady` (0x00200000)。 |
| **v1** | **重大變更**：移除八個未使用的旗標：`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](/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdevicestatus.md)
- [GameInputDeviceCallback](/zh-TW/reference/input/gameinput/functions/gameinputdevicecallback.md)
- [GetHapticInfo](/zh-TW/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_gethapticinfo.md)
- [IGameInput::RegisterDeviceCallback](/zh-TW/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)
- [GameInput](/zh-TW/reference/input/gameinput/gameinput_members.md)