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

# IGameInput::CreateAggregateDevice

> IGameInput::CreateAggregateDevice

# IGameInput::CreateAggregateDevice

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

## 구문

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

### 매개변수

*inputKind*   \_In\_\
형식: [GameInputKind](https://docs.xbox.com/ko/reference/input/gameinput/enums/gameinputkind.md)

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

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

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

### 반환값

형식: HRESULT

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

## 설명

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

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

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

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

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

## 요구 사항

**헤더:** GameInput.h

[Input API 개요](https://docs.xbox.com/ko/build/core-features/common/input/overviews/input-overview.md)\
[IGameInput](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinput/igameinput.md)

## 버전 기록

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


## Related topics

- [IGameInput::DisableAggregateDevice](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_disableaggregatedevice.md)
- [CreateRawDeviceReport](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_createrawdevicereport.md)
- [IGameInput::CreateDispatcher](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_createdispatcher.md)
- [IGameInput::FindDeviceFromId](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_finddevicefromid.md)
- [IGameInput::RegisterDeviceCallback](https://docs.xbox.com/ko/reference/input/gameinput/interfaces/igameinput/methods/igameinput_registerdevicecallback.md)