Skip to main content

XLaunchRestartOnCrash

Automatically restarts the game when the currently running instance of the game abnormally terminates due to a crash.

Syntax

Parameters

args   _In_opt_z_
Type: char*
Any applicable, game-specific arguments with which to relaunch the game. reserved   _In_
Type: uint32_t
Reserved. Must be set to 0.

Return value

Type: HRESULT HRESULT success or error code.

Remarks

Like XLaunchNewGame, XLaunchRestartOnCrash guarantees that only one game executable is running at a time. The internal state which determines if a new executable is to be launched when a crash is detected is tied to the lifetime of the current game instance. Relaunched game instances must also call XLaunchRestartOnCrash again if the relaunch behavior is still desired.
If a title calls XLaunchRestartOnCrash and then later
XLaunchNewGame and subsequently crashes prior to starting up the new game, the calling game will get restarted as opposed to the new launch specified via XLaunchNewGame.
This API is not meant to be used in retail scenarios and will return E_NOTIMPL
if it is invoked on a console which is not a devkit.

Requirements

Header: XGame.h Library: xgameruntime.lib Supported platforms: XBOX One family consoles and XBOX Series consoles

See also

XGame
Last modified on August 20, 2026