SYSRelaunchTitle

Syntax

#include <cafe/sysapp.h>

s32 SYSRelaunchTitle( u32 argc, char * pa_Argv[ ] );

Parameters

argc The number of string arguments stored in pa_Argv.
pa_Argv An array of null-terminated strings.

Return Values

SYS_ERROR_NONE The function completed successfully.
SYS_ERROR_FATAL A critical error occurred.

Description

Restarts the current title with new parameters.

NOTE:
  • When this function is called, memory is cleared. There is no difference between normal startup and calling SYSRelaunchTitle in terms of how memory is cleared.
  • During relaunch, the last frame of the game is displayed on the TV screen without any audio playing.
  • Calling this function causes the current application to exit.
  • The calling process receives a RELEASE_FOREGROUND message followed by an EXIT message via the system message queue. The process needs to wait for these messages before shutdown.
  • Unlike the OSRestartGame (deprecated) function and Title Launcher in the System Config Tool , this function checks the region setting when called.

Do Not Call From

Background Do not call this function from the background.
Multiple threads This function is not thread-safe.

Revision History

2013/05/08 Automated cleanup pass.
2012/10/01 Updated error codes.
2012/08/15 Initial version.


CONFIDENTIAL