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

> GetDeviceStatus

# GetDeviceStatus

입력 장치의 현재 상태를 검색합니다.

## 구문

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

### 매개변수

이 메서드에는 매개변수가 없습니다.

### 반환값

형식: [GameInputDeviceStatus](https://docs.xbox.com/ko/reference/input/gameinput/enums/gameinputdevicestatus.md)

반환된 값은 열거형 `GameInputDeviceStatus`입니다. 반환된 값은 [GameInputDeviceStatus](https://docs.xbox.com/ko/reference/input/gameinput/enums/gameinputdevicestatus.md)의 열거된 플래그 값 조합일 수 있습니다.

## 설명

반환된 [GameInputDeviceStatus](https://docs.xbox.com/ko/reference/input/gameinput/enums/gameinputdevicestatus.md) 열거형은 장치가 연결되어 있는지 여부와 게임과 장치 사이에서 전송될 수 있는 입력 및 출력 유형을 정의합니다. 장치가 시스템에서 분리된 상태에서 `GetDeviceStatus` 메서드가 호출되면 `GameInputDeviceNoStatus` 값이 반환됩니다. `GameInputDeviceStatus` 열거형을 [RegisterDeviceCallback](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md) 메서드의 필터로 사용하여 장치 상태의 특정 변경에 반응할 수 있습니다.

## 요구 사항

**헤더:** GameInput.h

[GameInput 개요](https://docs.xbox.com/ko/build/core-features/common/input/overviews/input-overview.md)\
[GameInputDeviceStatus](https://docs.xbox.com/ko/reference/input/gameinput/enums/gameinputdevicestatus.md)\
[RegisterDeviceCallback](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)\
[IGameInputDevice](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)

## 버전 기록

| 버전 | 변경 사항 |
| - | - |
| **v0** | 도입됨. |


## Related topics

- [GameInputDeviceStatus](https://docs.xbox.com/ko/reference/input/gameinput/enums/gameinputdevicestatus.md)
- [IGameInputDevice (인터페이스 콘텐츠)](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)
- [Get Play Fab IDs From Nintendo Switch Device Ids](https://docs.xbox.com/api-reference/account-management/get-play-fab-ids-from-nintendo-switch-device-ids.md)
- [GetHapticInfo](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_gethapticinfo.md)
- [Report Device Info](https://docs.xbox.com/api-reference/analytics/report-device-info.md)