Skip to main content

XGameRuntimeInitialize

初始化 Gaming Runtime。

Syntax

Parameters

无。

Return value

类型:HRESULT 如果成功,则返回 S_OK;否则返回错误代码。有关错误代码的列表,请参阅错误代码。如果由于找不到 Gaming Runtime 库 (xgameruntime.dll) 而导致该函数失败,则返回值设置为 E_GAMERUNTIME_DLL_NOT_FOUND

Remarks

若要在游戏中使用 Gaming Runtime 功能,请先通过调用 XGameRuntimeInitialize 函数初始化 Gaming Runtime。请尽早调用 XGameRuntimeInitialize 函数,通常在游戏的入口点函数中调用。同样,通过调用 XGameRuntimeUninitialize 函数,尽可能晚地(但需在游戏退出之前)取消初始化 Gaming Runtime。 每个针对游戏运行时进行编译和链接的二进制文件都应在启动早期调用 XGameRuntimeInitialize。这包括游戏二进制文件和以 DLL 形式使用 Gaming Runtime 功能的任何中间件。在 XGameRuntimeInitialize 函数内部,将检查标题所编译对应的所有接口版本,并用于初始化匹配的运行时服务。在两个不同版本的 Gaming Runtime 之间,函数可能会被添加、删除,或在极少数情况下发生破坏性行为更改。从每个组件调用 XGameRuntimeInitialize 将有助于检测生成配置问题,例如两个不同二进制文件针对两个不同且不兼容版本的游戏运行时进行编译(这些二进制文件将在同一进程中加载)。此类破坏性配置将导致 E_GAMERUNTIME_VERSION_MISMATCH 错误。 以下示例演示了如何在基于 Visual Studio 中 Direct3D 12 Desktop Game 模板的游戏的入口点函数中使用 XGameRuntimeInitializeXGameRuntimeUninitialize 函数。在实例化并注册 Game 对象之前调用 XGameRuntimeInitialize 函数,并在重置 Game 对象之后但在入口点函数返回之前调用 XGameRuntimeUninitialize 函数。

Requirements

头文件: XGameRuntimeInit.h 库: xgameruntime.lib 受支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机

Conceptual documentation

See also

XGameRuntimeUninitialize
XGameRuntimeInitializeWithOptions
XGameRuntimeInit
XGameRuntime 结构
XGameRuntime 枚举
使用 Gaming Runtime 开发新标题
最后修改于 2026年8月24日