Skip to main content

​
XtfStartTitleOS

Starts or restarts the specified Game OS.

​
Syntax

​
Parameters

address
Type: PCWSTR [in] The address of the console. osIdentifier
Type: PCWSTR [in, optional] The identifier of the Game OS to be started. This identifier can be one of the following:
  • The full path and file name of a MicrosoftGame.config file that contains the four-part version number of the Game OS version to be started
  • The full path and file name of a GameOs.xvd file
  • The full path to a directory that contains a MicrosoftGame.config or GameOS.vxd file
  • The four-part version number of the Game OS to be started
Examples of valid identifiers:
  • D:\MyGame
  • \MyDevPC\share\MyGame\MicrosoftGame.config
  • xd:\Titles\MyGamePFN\GameOs.xvd
  • 10.0.18236.1002

​
Return value

Type: HRESULT Returns S_OK if successful; otherwise, returns an HRESULT error code.

​
Remarks

Use this function to start or restart the specified Game OS from the cache on the console. If you have a FourPartVersion for the Game OS you want to start, use the XtfStartTitleOSByVersion function instead to start that Game OS version. You can use the XtfGetCachedTitleOSVersions function to get the FourPartVersion of each Game OS cached on the console, or the XtfGetTitleOSFourPartVersion function to get the FourPartVersion of the Game OS for the currently running title. You can also use the XtfStartTitleOSByGameConfig function to start the Game OS identified in the specified contents of a MicrosoftGame.config file. If needed, you can add a Game OS to the cache on the console by calling the XtfCacheTitleOS function. For more information about managing provisioned Game OS files, see Application Management (xbapp.exe) (NDA topic) and Provision (xbprovision.exe) (NDA topic).

​
Requirements

Header: xtfapi.h Library: XtfApi.lib Supported platforms: Windows (for XBOX console tools)

​
See also

Run from PC Deployment (NDA topic)
XTF Transport Errors (NDA topic)
Additional Xtf APIs
Last modified on August 20, 2026