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

# GetDeviceInfo

> GetDeviceInfo

# GetDeviceInfo

입력 장치의 전체 속성 및 기능에 대한 정적 정보에 접근합니다.

## 구문

```cpp theme={null}
HRESULT GetDeviceInfo(
    const GameInputDeviceInfo** info
);
```

### 매개변수

*info*   \_Outptr\_\
형식: GameInputDeviceInfo\*\*

IGameInputDevice와 연관된 장치 정보입니다.

### 반환값

형식: HRESULT

함수 결과.

## 설명

`GetDeviceInfo` 메서드 메모리는 애플리케이션이 소유하지 않습니다. `IGameInput` 인스턴스가 애플리케이션에 의해 유지되면 메모리는 계속 접근 가능합니다. `IGameInput` 개체에 대한 참조가 해제되면 메모리가 사라집니다.

다음 코드 예제는 레이싱 휠에 클러치가 있는지 확인하는 방법을 보여줍니다.

```cpp theme={null}
bool HasClutch(IGameInputDevice* wheel) noexcept
{
    const GameInputDeviceInfo* wheelInfo = nullptr;
    const bool succeeded = wheel->GetDeviceInfo(&wheelInfo);
    assert(succeeded);
    assert(wheelInfo->racingWheelInfo);

    const bool hasClutch = wheelInfo->racingWheelInfo->hasClutch;

    return hasClutch;
}
```

## 요구 사항

**헤더:** GameInput.h

[GameInput 개요](https://docs.xbox.com/ko/build/core-features/common/input/overviews/input-overview.md)\
[GameInputDeviceInfo](https://docs.xbox.com/ko/reference/input/gameinput/structs/gameinputdeviceinfo.md)\
[IGameInputDevice](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)

## 버전 기록

| 버전 | 변경 사항 |
| - | - |
| **v3** | 시그니처는 변경되지 않음. [GameInputDeviceInfo](https://docs.xbox.com/ko/reference/input/gameinput/structs/gameinputdeviceinfo.md) 확장됨: `controllerInfo` 추가(별도의 axis/button/switch count+info 필드 및 `uiNavigationInfo` 대체); `inputReportCount`/`inputReportInfo` 및 `outputReportCount`/`outputReportInfo` 추가; `hapticFeedbackMotorInfo` 제거. |
| **v2** | 시그니처는 변경되지 않음. [GameInputDeviceInfo](https://docs.xbox.com/ko/reference/input/gameinput/structs/gameinputdeviceinfo.md)가 `revisionNumber`, `hardwareVersion`, `firmwareVersion`, `containerId`, `sensorsInfo`로 확장됨. |
| **v1** | 시그니처는 변경되지 않음. [GameInputDeviceInfo](https://docs.xbox.com/ko/reference/input/gameinput/structs/gameinputdeviceinfo.md)가 크게 단순화됨: `infoSize`, `interfaceNumber`, `collectionNumber`, `capabilities`, touch/haptic/string/descriptor 필드 제거; `supportedSystemButtons`, `displayName`, `pnpPath` 추가. |
| **v0** | 도입됨. |


## Related topics

- [GameInputGamepadInfo](https://docs.xbox.com/ko/reference/input/gameinput/structs/gameinputgamepadinfo.md)
- [GameInputDeviceFamily](https://docs.xbox.com/ko/reference/input/gameinput/enums/gameinputdevicefamily.md)
- [GameInputArcadeStickInfo](https://docs.xbox.com/ko/reference/input/gameinput/structs/gameinputarcadestickinfo.md)
- [GameInputFlightStickInfo](https://docs.xbox.com/ko/reference/input/gameinput/structs/gameinputflightstickinfo.md)
- [GameInputControllerInfo](https://docs.xbox.com/ko/reference/input/gameinput/structs/gameinputcontrollerinfo.md)