Skip to main content

IGameInput::CreateAggregateDevice

创建一个虚拟的 IGameInputDevice 实例,该实例聚合指定 GameInputKind 的所有输入。

语法

参数

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 输入 API 概述
IGameInput

版本历史

最后修改于 2026年8月13日