> ## 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](/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdevicestatus)에서 반환됩니다.

애플리케이션은 [IGameInput 인터페이스](/reference/input/gameinput/interfaces/igameinput/igameinput)의 [IGameInput::RegisterDeviceCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback) 메서드를 통해 이러한 상태가 변경될 때 콜백을 수신하도록 등록할 수 있습니다.

## 요구 사항

**헤더:** GameInput.h

[Input API 개요](/build/core-features/common/input/overviews/input-overview)\
[GameInput](/reference/input/gameinput/gameinput_members)\
[IGameInput::RegisterDeviceCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback)

## 버전 기록

| 버전     | 변경 사항                                                                                                                                                                                                                                                                                                                                                    |
| ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **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](/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdevicestatus.md)
- [GameInputDeviceCallback](/ko/reference/input/gameinput/functions/gameinputdevicecallback.md)
- [IGameInput::RegisterDeviceCallback](/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)
- [GameInput](/ko/reference/input/gameinput/gameinput_members.md)
- [GameInputBatteryStatus](/ko/reference/input/gameinput/deprecated/enums/gameinputbatterystatus.md)