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

# IGameInput::CreateAggregateDevice

> IGameInput::CreateAggregateDevice

# IGameInput::CreateAggregateDevice

지정된 [GameInputKind](/reference/input/gameinput/enums/gameinputkind)의 모든 입력을 집계하는 가상 [IGameInputDevice](/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice) 인스턴스를 만듭니다.

## 구문

```cpp theme={null}
HRESULT CreateAggregateDevice(
         GameInputKind inputKind,
         APP_LOCAL_DEVICE_ID* deviceId
)
```

### 매개변수

*inputKind*   \_In\_\
형식: [GameInputKind](/reference/input/gameinput/enums/gameinputkind)

반환되는 가상 [IGameInputDevice](/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice)가 판독 값을 집계할 입력 유형입니다.

*deviceId*   \_Out\_\
형식: APP\_LOCAL\_DEVICE\_ID\*

집계 장치에 대해 생성된 장치 식별자입니다.

### 반환값

형식: HRESULT

함수 결과. 지원되지 않는 [GameInputKind](/reference/input/gameinput/enums/gameinputkind)가 사용되거나 [GameInputKind](/reference/input/gameinput/enums/gameinputkind) 플래그를 결합하려고 할 때 실패를 반환합니다.

## 설명

CreateAggregateDevice에 사용되는 입력 종류는 [GameInputKind](/reference/input/gameinput/enums/gameinputkind) 열거형의 단일 값이어야 합니다. [GameInputKind](/reference/input/gameinput/enums/gameinputkind) 플래그의 결합은 지원되지 않습니다. 애플리케이션이 여러 입력 종류에 대해 집계 입력이 필요한 경우, 각각에 대해 가상 [IGameInputDevice](/reference/input/gameinput/interfaces/igameinputdevice/igameinputdevice) 인스턴스를 만들어야 합니다.

<Note>이 함수는 [DisableAggregateDevice](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_disableaggregatedevice)를 호출하여 비활성화되었을 수 있는 집계 장치를 다시 활성화하는 데 사용됩니다. 이는 다른 인스턴스를 만드는 것이 아니라 장치를 다시 활성화하는 결과가 됩니다.</Note>

집계 장치는 또한 [RegisterDeviceCallback](/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback)을 호출하여 등록된 콜백을 통해 상태 알림을 발송합니다.

집계는 다음 입력 종류에 대해서만 지원됩니다:

* GameInputKindKeyboard
* GameInputKindMouse
* GameInputKindArcadeStick
* GameInputKindFlightStick
* GameInputKindGamepad
* GameInputKindRacingWheel

## 요구 사항

**헤더:** GameInput.h

[Input API 개요](/build/core-features/common/input/overviews/input-overview)\
[IGameInput](/reference/input/gameinput/interfaces/igameinput/igameinput)

## 버전 기록

| 버전     | 변경 사항                                                                                        |
| ------ | -------------------------------------------------------------------------------------------- |
| **v3** | 구현됨(v0에서는 E\_NOTIMPL이었음) 및 재도입됨. 시그니처 변경: `IGameInputDevice**`가 `APP_LOCAL_DEVICE_ID*`로 대체됨. |
| **v1** | 제거됨.                                                                                         |
| **v0** | 도입되었으나 구현되지 않음.                                                                              |