IGameInput::CreateAggregateDevice

注意

尚未实现此函数。

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

语法

HRESULT CreateAggregateDevice(  
         GameInputKind inputKind,  
         IGameInputDevice** device  
)  

参数

inputKind _In_
类型:GameInputKind

返回的虚拟 IGameInputDevice 将为其聚合读取的输入类型。

device _COM_Outptr_
类型:IGameInputDevice**

最终生成的 IGameInputDevice。 将在出错时返回 null。

返回值

类型:HRESULT

尚未实现此函数。 返回 E_NOTIMPL。

在使用了不支持的 GameInputKind 时,或者在尝试合并GameInputKind 标志时,计划的实现通常返回一个错误。

备注

在对 CreateAggregateDevice 方法的调用中指定的输入类型必须是来自 GameInputKind 枚举的单个值;不支持合并 GameInputKind 标志。 如果某一应用程序需要针对多个输入类型的聚合输入,则必须为每种类型都创建一个虚拟 IGameInputDevice 实例。

有几种从聚合角度来说没有什么意义的输入类型。 为避免奇怪或意外行为,不支持以下输入类型的聚合:

  • GameInputKindRawDeviceReport
  • GameInputKindController
  • GameInputKindTouch
  • GameInputKindMotion

要求

头文件:GameInput.h

库:xgameruntime.lib

支持平台:Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

输入 API 概述
IGameInput