1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
6<META http-equiv="Content-Style-Type" content="text/css">
7<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
8<title>OSRestart</title>
9</head>
10
11<body>
12
13<h1>OSRestart</h1>
14
15
16<h2>C Specification</h2>
17
18<dl>
19<dd><pre><code>#include &lt;revolution/os.h&gt;</code></pre></dd>
20<dd><pre><code>void OSRestart(u32 resetCode);</code></pre></dd>
21</dl>
22
23<h2>Arguments</h2>
24<table border="1" cellpadding="3" cellspacing="0.1">
25  <tr>
26<td width="120" bgcolor="#ffffe8"><i><b><code>resetCode</code></b></i></td>
27<td width="520">Only the low-order 29 bits are valid. Any value freely specified here ahead of time can be retrieved after restart using the <A href="OSGetResetCode.html"><CODE>OSGetResetCode</CODE></A> function. If <code><A href="OSRestart.html">OSRestart</A></code> is called and a game disc cannot be found or the current game differs from the current disc, make sure that a reset code of 0 is always passed to the next game at run-time.</td>
28  </tr>
29</table>
30
31<h2>Return Values</h2>
32<P>None.</P>
33
34<h2>Description</h2>
35<P><CODE>OSRebootSystem</CODE> executes a restart. &quot;Restart&quot; means that the function reloads the application and jumps to the start of the application.</P>
36
37<P>You must be aware of the cautions indicated in the <A>Reset and Shutdown Functions</A> when calling this function.</P>
38
39<P><STRONG>Note:</STRONG> There is no guarantee that any data in memory will remain after restart. Data loss in a specified region can be avoided by using the <A href="OSSetSaveRegion.html"><CODE>OSSetSaveRegion</CODE></A> function.</P>
40
41<h2>See Also</h2>
42<P><a target="contents" href="../toc.html#Reset">Reset and Shutdown Functions</a></P>
43
44<H2>Revision History</H2>
45<P>2006/10/25 Revised explanation. <BR>2006/08/10 Initial version.</P>
46
47<hr>
48<P>CONFIDENTIAL</p>
49</BODY>
50</HTML>