XtfStartTitleOS
启动或重启指定的游戏 OS。
语法
HRESULT XtfStartTitleOS(
PCWSTR address,
PCWSTR osIdentifier
)
参数
address
类型：PCWSTR
[in] 主机的地址。
osIdentifier
类型：PCWSTR
[in, optional] 要启动的游戏 OS 的标识符。 此标识符可以是以下值之一：
- MicrosoftGame.config 文件的完整路径和文件名，其中包含要启动的游戏 OS 版本由四部分组成的版本号
- GameOs.xvd 文件的完整路径和文件名
- 包含 MicrosoftGame.config 或 GameOS.vxd 文件的目录的完整路径
- 要启动的游戏 OS 由四部分组成的版本号
有效标识符的示例：
- D:\MyGame
- \MyDevPC\share\MyGame\MicrosoftGame.config
- xd:\Titles\MyGamePFN\GameOs.xvd
- 10.0.18236.1002
返回值
类型：HRESULT
如果成功，返回 S_OK；否则返回 HRESULT 错误代码。
备注
使用此函数从主机上的缓存启动或重启指定的游戏 OS。
如果你想要启动的游戏 OS 有 FourPartVersion，请改为使用 XtfStartTitleOSByVersion 函数启动该游戏 OS 版本。 可使用 XtfGetCachedTitleOSVersions 函数获取主机上缓存的每个游戏 OS 的 FourPartVersion，或使用 XtfGetTitleOSFourPartVersion 函数获取当前运行的游戏的游戏 OS 的 FourPartVersion。 还可使用 XtfStartTitleOSByGameConfig 函数启动在 MicrosoftGame.config 文件的指定内容中标识的游戏 OS。
如果需要，可调用 XtfCacheTitleOS 函数将游戏 OS 添加到主机上的缓存。 有关管理预配的游戏 OS 文件的详细信息，请参阅应用程序管理 (xbapp.exe)(NDA 主题)要求授权 和 预配 (xbprovision.exe)(NDA 主题)要求授权。
要求
头文件：xtfapi.h
库：XtfApi.lib
支持平台：Windows（适用于 Xbox 主机工具）