XtfCacheTitleOS
向 OS 缓存添加游戏 OS。
语法
HRESULT XtfCacheTitleOS(
PCWSTR address,
PCWSTR osIdentifier
)
参数
address
类型:PCWSTR
[in] 主机的地址。
osIdentifier
类型:PCWSTR
[in]要添加的游戏 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 文件。 可使用 XtfGetCachedTitleOSVersions 函数获取主机上缓存的每个游戏 OS 的版本信息。 还可调用 XtfRemoveTitleOSFromCache 或 XtfRemoveTitleOSFromCacheByVersion 函数,从缓存中删除现有游戏 OS。 有关管理预配的游戏操作系统文件的详细信息,请参阅应用程序管理 (xbapp.exe)(NDA 主题)要求授权和预配 (xbprovision.exe)(NDA 主题)要求授权。
要求
头文件:xtfapi.h
库:XtfApi.lib
支持平台:Windows(适用于 Xbox 主机工具)