Skip to main content

XtfStartTitleOS

启动或重新启动指定的 Game OS。

语法

参数

address
类型:PCWSTR
[in] 主机的地址。 osIdentifier
类型:PCWSTR
[in, optional] 要启动的 Game OS 的标识符。此标识符可以是以下之一:
  • MicrosoftGame.config 文件的完整路径和文件名,该文件包含要启动的 Game OS 版本的四部分版本号
  • GameOs.xvd 文件的完整路径和文件名
  • 包含 MicrosoftGame.config 或 GameOS.vxd 文件的目录的完整路径
  • 要启动的 Game OS 的四部分版本号
有效标识符的示例:
  • D:\MyGame
  • \MyDevPC\share\MyGame\MicrosoftGame.config
  • xd:\Titles\MyGamePFN\GameOs.xvd
  • 10.0.18236.1002

返回值

类型:HRESULT 如果成功则返回 S_OK;否则返回 HRESULT 错误代码。

备注

使用此函数从主机的缓存中启动或重新启动指定的 Game OS。 如果你有想要启动的 Game OS 的 FourPartVersion,请改用 XtfStartTitleOSByVersion 函数来启动该 Game OS 版本。你可以使用 XtfGetCachedTitleOSVersions 函数获取主机上缓存的每个 Game OS 的 FourPartVersion,或使用 XtfGetTitleOSFourPartVersion 函数获取当前正在运行的标题的 Game OS 的 FourPartVersion。你还可以使用 XtfStartTitleOSByGameConfig 函数启动在指定 MicrosoftGame.config 文件内容中标识的 Game OS。 如果需要,你可以通过调用 XtfCacheTitleOS 函数向主机的缓存中添加 Game OS。有关管理已预配 Game OS 文件的详细信息,请参阅应用程序管理 (xbapp.exe) (NDA 主题)预配 (xbprovision.exe) (NDA 主题)

要求

头文件: xtfapi.h 库: XtfApi.lib 支持的平台: Windows(用于 XBOX 主机工具)

另请参阅

Run from PC Deployment (NDA 主题)
XTF 传输错误 (NDA 主题)
其他 Xtf API
最后修改于 2026年8月24日