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

# 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 개요](/build/core-features/common/input/overviews/input-overview)\
[GameInputDeviceInfo](/reference/input/gameinput/structs/gameinputdeviceinfo)\
[IGameInputDevice](/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice)

## 버전 기록

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


## Related topics

- [GameInputDeviceFamily](/ko/reference/input/gameinput/enums/gameinputdevicefamily.md)
- [GameInput의 포스 피드백](/ko/build/core-features/common/input/advanced/input-forcefeedback.md)
- [사용자 및 입력 장치](/ko/build/core-features/common/user/users-input-devices.md)
- [GameInput API 버전 관리](/ko/build/core-features/common/input/overviews/input-versioning.md)
- [player_device_info](/ko/services/playfab/api-references/events/PlayerIdentity/player-device-info.md)