> ## 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 (사용되지 않음)

> 입력 장치의 전체 속성 및 기능에 대한 정적 정보에 접근합니다(v4에서 제거됨).

> [!WARNING]
>
> **사용되지 않음.** 이 메서드는 GameInput v4에서 제거되었으며 현재 API에서는 사용할 수 없습니다. 대신 [GetVendorId](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getvendorid.md) 및 [GetRacingWheelInfo](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getracingwheelinfo.md)와 같은 [IGameInputDevice](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)의 개별 getter 메서드를 사용하세요. 각 [GameInputDeviceInfo](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/structs/gameinputdeviceinfo.md) 멤버와 해당 대체 항목의 매핑은 해당 페이지의 설명 섹션을 참조하세요.

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

## 구문

```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 = SUCCEEDED(wheel->GetDeviceInfo(&wheelInfo));
    assert(succeeded);
    assert(wheelInfo->racingWheelInfo);

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

    return hasClutch;
}
```

## 요구 사항

**헤더:** GameInput.h

## 함께 보기

[사용되지 않는 GameInput API 멤버](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/gameinput_deprecated_members.md)\
[GameInput 개요](https://docs.xbox.com/ko/build/core-features/common/input/overviews/input-overview.md)\
[GameInputDeviceInfo](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/structs/gameinputdeviceinfo.md)\
[IGameInputDevice](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)

## 버전 기록

| 버전 | 변경 사항 |
| - | - |
| **v4** | 제거됨. |
| **v3** | 시그니처는 변경되지 않음. [GameInputDeviceInfo](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/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/deprecated/structs/gameinputdeviceinfo.md)가 `revisionNumber`, `hardwareVersion`, `firmwareVersion`, `containerId`, `sensorsInfo`로 확장됨. |
| **v1** | 시그니처는 변경되지 않음. [GameInputDeviceInfo](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/structs/gameinputdeviceinfo.md)가 크게 단순화됨: `infoSize`, `interfaceNumber`, `collectionNumber`, `capabilities`, touch/haptic/string/descriptor 필드 제거; `supportedSystemButtons`, `displayName`, `pnpPath` 추가. |
| **v0** | 도입됨. |


## Related topics

- [GameInputDeviceInfo (사용되지 않음)](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/structs/gameinputdeviceinfo.md)
- [GameInputControllerInfo (사용되지 않음)](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/structs/gameinputcontrollerinfo.md)
- [GetDeviceStatus (사용되지 않음)](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getdevicestatus.md)
- [IGameInputDevice::GetBatteryState (사용되지 않음)](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getbatterystate.md)
- [IGameInputDevice::GetRawDeviceFeature (사용되지 않음)](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getrawdevicefeature.md)