XLaunchNewGame

Syntax

void XLaunchNewGame(  
         const char* exePath,  
         const char* args,  
         XUserHandle defaultUser  
)  

Parameters

exePath _In_z_
类型：char*

要启动的新游戏的路径和文件名。此路径可以相对于当前目录，也可以是绝对路径。需要知道调用可执行文件路径的游戏可以调用 GetModuleFileNameA，并将模块句柄设置为 nullptr。

args _In_opt_z_
类型：char*

用于启动新游戏的任何适用的、特定于游戏的参数。

defaultUser _In_opt_
类型：XUserHandle

启动新游戏的用户的句柄。如果未指定值，则指定当前用户。

Return value

类型：void

此函数不返回值，也不引发异常，即使无法重启游戏也是如此。

Remarks

此函数在时间敏感型线程上调用是不安全的。有关详细

信息，请参阅时间敏感型线程。

此函数会重启游戏，结束游戏的当前进程，并使用新进程重启游戏。游戏会在不重启其运行所在的虚拟机的情况下重启。你可以选择指定不同的默认用户以及用于重启游戏的特定于游戏的参数；有关指定不同默认用户的详细信息，请参阅用户身份和 XUser。

即使函数在启动新游戏时遇到错误，当前进程也始终会被终止。例如，如果为 exePath、args 或 defaultUser 指定的任何值无效，该函数将不返回值，也不引发异常。

调用此函数后，所有以前挂载的 DLC 都将

被卸载，但托管 XLaunchNewGame 目标的 DLC 除外。G: 驱动器将继续指向基础包的根目录，而不是新启动的 EXE。

如果调用 XLaunchNewGame 后但在新启动的游戏设置其挂起处理程序之前游戏被挂起，

则该游戏将被终止。这是一个非常狭窄的时间窗口，实际发生的可能性极低。

使用 XMemTransferMemory (NDA topic) 传输到系统的内存将被保留。

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

XLaunchNewGame

Syntax

Parameters

Return value

Remarks

Requirements

Conceptual documentation

See also

​XLaunchNewGame

​Syntax

​Parameters

​Return value

​Remarks

​Requirements

​Conceptual documentation

​See also

XLaunchNewGame

Syntax

Parameters

Return value

Remarks

Requirements

Conceptual documentation

See also