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 主机