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

# IGameInputDevice::GetDeviceRootId

> 입력 장치에 대한 루트 장치 노드의 애플리케이션 로컬 ID를 가져옵니다.

입력 장치에 대한 루트 장치 노드의 애플리케이션 로컬 ID를 가져옵니다.

## 구문

```cpp theme={null}
void GetDeviceRootId(
    APP_LOCAL_DEVICE_ID* deviceRootId
);
```

### 매개변수

*deviceRootId*   \_Out\_\
형식: [APP\_LOCAL\_DEVICE\_ID](https://docs.xbox.com/ko/reference/system/xuser/structs/app_local_device_id.md)\*

루트 장치 노드의 애플리케이션 로컬 ID를 받습니다.

### 반환값

형식: void

## 설명

루트 장치 ID는 복합 장치의 루트 장치 노드를 식별하는 애플리케이션 로컬 ID입니다. 이를 통해 애플리케이션이 개별 장치 간의 관계를 파악할 수 있습니다. 예를 들어, 일부 게이밍 키보드는 여러 키보드 노드를 가진 복합 장치로 자신을 노출하여 동시 8개 키 입력이라는 레거시 USB 제한을 우회합니다. 이러한 노드는 "시스템" 키보드로 병합되므로 일반적으로 사용자에게는 투명합니다. 그러나 GameInput API로 키보드별 입력을 처리할 때 이 관계를 이해하면 애플리케이션이 기능을 키 입력에 매핑할 때 부적절한 가정(예: 키 입력이 항상 특정 장치에서 온다는 가정)을 피하는 데 도움이 됩니다.

같은 루트 장치 ID를 보고하는 장치는 동일한 복합 장치에 속합니다. 장치가 복합 장치의 여러 인터페이스 중 하나가 아니면 루트 장치 ID는 [IGameInputDevice::GetDeviceId](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceid.md)가 반환하는 ID와 동일합니다.

GameInput v3 이하에서는 [IGameInputDevice::GetDeviceInfo](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceinfo.md)가 반환하는 [GameInputDeviceInfo](https://docs.xbox.com/ko/reference/input/gameinput/deprecated/structs/gameinputdeviceinfo.md) 구조체의 `deviceRootId` 멤버에서 이 정보를 얻을 수 있었습니다.

## 요구 사항

**헤더:** GameInput.h

**라이브러리:** gameinput.lib

**지원되는 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 함께 보기

[GameInput 개요](https://docs.xbox.com/ko/build/core-features/common/input/overviews/input-overview.md)\
[IGameInputDevice](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)\
[IGameInputDevice::GetDeviceId](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceid.md)\
[IGameInputDevice::GetContainerId](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontainerid.md)\
[APP\_LOCAL\_DEVICE\_ID](https://docs.xbox.com/ko/reference/system/xuser/structs/app_local_device_id.md)

## 버전 기록

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


## Related topics

- [IGameInputDevice::GetDeviceId](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getdeviceid.md)
- [IGameInputDevice::GetContainerId](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getcontainerid.md)
- [IGameInputDevice (인터페이스 콘텐츠)](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice.md)
- [IGameInputDevice::GetVendorId](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getvendorid.md)
- [IGameInputDevice::GetProductId](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getproductid.md)