Skip to main content

GameInputCreate

获取 IGameInput 接口的实例。

语法

参数

gameInput   _COM_Outptr_
类型:IGameInput**
调用返回的底层每进程单例的实例。

返回值

类型:HRESULT 函数结果。

备注

GameInputCreate 函数是一个用于获取或创建 GameInput 实例的 Nano-COM 工厂。生成的接口由每个进程的单例支持,该单例在首次调用此函数时创建。因此,首次调用此函数可能需要少量时间才能返回——此时间足够短,通常从 UI 线程调用是安全的,但不适合从时间敏感的上下文(例如游戏循环)中调用。同一进程后续对该函数的调用仅会向底层单例添加另一个引用并快速返回。 由于系统上一次只有一个 GameInput 版本可用,因此支持的接口集可能会因所安装的 GameInput 版本而异。由于 GameInput 向后兼容,即使在添加新功能的同时,新版本也会继续支持旧接口。 应用程序应在启动期间调用一次 GameInputCreate 函数,并保留 IGameInput 对象引用,直到应用程序准备好关闭。即使对于响应进程生命周期管理 (PLM) 挂起事件的通用 Windows 平台 (UWP) 应用,这也适用,因为重新初始化 GameInput 单例(当应用恢复时)的开销通常超过在应用程序中释放少量内存所带来的好处。

要求

标头: GameInput.h 高级 GameInput 主题
GameInput 概述
GameInput

版本历史

概念文档

最后修改于 2026年8月13日