获取 IGameInput 接口的实例。
语法
HRESULT GameInputCreate(
IGameInput** gameInput
);
参数
gameInput _COM_Outptr_
类型:IGameInput**
通过调用返回的基础每进程单一实例的实例。
返回值
类型:HRESULT
函数结果。
备注
函数 GameInputCreate
是一个 Nano-COM 工厂,用于获取或创建 GameInput 实例。 生成的接口由首次调用此函数时创建的按进程单一实例提供支持。 因此,首次调用此函数可能只需很短的时间即可返回,时间短到通常足以安全地从 UI 线程进行调用,但不能从敏感上下文(如游戏循环)中进行调用。 后续从同一进程调用此函数只是添加对基础单一实例的另一次调用,这会快速返回。
由于系统一次只有一个版本的 GameInput 可用,因此支持的接口集可能因安装的 GameInput 版本而异。 由于 GameInput 是向后兼容的,因此新版本将继续支持旧接口,即使添加新功能。
应用程序应在启动期间调用一次 GameInputCreate
函数,并保留 IGameInput
对象参考,直到该应用程序已准备好关闭。 这甚至适用于响应进程周期管理 (PLM) 挂起事件的通用 Windows 平台 (UWP) 应用,因为(当应用恢复时)重新初始化 GameInput
单一实例的代价超过了释放应用程序中少量内存的好处。
注意
重 GameInputCreate(GameInputLegacy**)
载存在只是出于旧兼容性原因;游戏不应直接调用它。
要求
头文件:GameInput.h
库:gameinput.lib
支持的平台: 窗户