GameInputCreate

获取 IGameInput 接口的实例。

语法

HRESULT GameInputCreate(  
         IGameInput** gameInput  
)  

参数

gameInput _COM_Outptr_
类型:IGameInput**

通过调用返回的基础每进程单一实例的实例。

返回值

类型:HRESULT

函数结果。

备注

GameInputCreate 函数是 Nano-COM 工厂,用于获取 IGameInput 接口的实例。 IGameInput 接口在首次调用此函数时创建的每进程单一实例上实施。 因此,首次调用此函数可能只需很短的时间即可返回,时间短到通常足以安全地从 UI 线程进行调用,但不能从敏感上下文(如游戏循环)中进行调用。 后续从同一进程调用此函数只是添加对基础单一实例的另一次调用,这会快速返回。

应用程序应在启动期间调用一次 GameInputCreate 函数,并保留 IGameInput 对象参考,直到该应用程序已准备好关闭。 这甚至适用于响应进程周期管理 (PLM) 挂起事件的通用 Windows 平台 (UWP) 应用,因为(当应用恢复时)重新初始化 GameInput 单一实例的代价超过了释放应用程序中少量内存的好处。

要求

头文件:GameInput.h

库:xgameruntime.lib

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

另请参阅

高级 GameInput 主题
GameInput 概述
GameInput