Skip to main content

IGameInput::CreateAggregateDevice

지정된 GameInputKind의 모든 입력을 집계하는 가상 IGameInputDevice 인스턴스를 만듭니다.

구문

매개변수

inputKind   _In_
형식: GameInputKind
반환되는 가상 IGameInputDevice가 판독 값을 집계할 입력 유형입니다. deviceId   _Out_
형식: APP_LOCAL_DEVICE_ID*
집계 장치에 대해 생성된 장치 식별자입니다.

반환값

형식: HRESULT 함수 결과. 지원되지 않는 GameInputKind가 사용되거나 GameInputKind 플래그를 결합하려고 할 때 실패를 반환합니다.

설명

CreateAggregateDevice에 사용되는 입력 종류는 GameInputKind 열거형의 단일 값이어야 합니다. GameInputKind 플래그의 결합은 지원되지 않습니다. 애플리케이션이 여러 입력 종류에 대해 집계 입력이 필요한 경우, 각각에 대해 가상 IGameInputDevice 인스턴스를 만들어야 합니다.
이 함수는 DisableAggregateDevice를 호출하여 비활성화되었을 수 있는 집계 장치를 다시 활성화하는 데 사용됩니다. 이는 다른 인스턴스를 만드는 것이 아니라 장치를 다시 활성화하는 결과가 됩니다.
집계 장치는 또한 RegisterDeviceCallback을 호출하여 등록된 콜백을 통해 상태 알림을 발송합니다. 집계는 다음 입력 종류에 대해서만 지원됩니다:
  • GameInputKindKeyboard
  • GameInputKindMouse
  • GameInputKindArcadeStick
  • GameInputKindFlightStick
  • GameInputKindGamepad
  • GameInputKindRacingWheel

요구 사항

헤더: GameInput.h Input API 개요
IGameInput

버전 기록

마지막 수정일 2026년 8월 13일