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<h2>Syntax</h2> 16<dl><dd><pre class="construction"> 17#include <revolution/os.h> 18 19void OSRestart(u32 resetCode); 20</pre></dd></dl> 21 22<h2>Arguments</h2> 23<TABLE class="arguments" border="1" > 24 <tr> 25<th>resetCode</th> 26<td>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</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> 27 </tr> 28</table> 29 30<h2>Return Values</h2> 31<P>None.</P> 32 33<h2>Description</h2> 34<P>The <CODE>OSRestart</CODE> function executes a restart. "Restart" means that the function reloads the application and jumps to the start of the application.</P> 35 36<P>You must be aware of the cautions indicated in the <A>Reset and Shutdown Functions</A> when calling this function.</P> 37 38<P><B>Note:</B> There is no guarantee that any data in memory will remain after a restart. Data loss in a specified region can be avoided by using the <A href="OSSetSaveRegion.html"><CODE>OSSetSaveRegion</CODE></A> function.</P> 39 40<h2>See Also</h2> 41<P class="reference"> 42<a target="contents" href="../toc.html#Reset">Reset and Shutdown Functions</a>, 43<A HREF="OSGetResetCode.html">OSGetResetCode</A>, 44<A HREF="OSSetSaveRegion.html">OSSetSaveRegion</A> 45</P> 46 47<H2>Revision History</H2> 48<P> 492006/10/25 Revised explanation. <BR>2006/08/10 Initial version.<br> 50</P> 51 52<hr><p>CONFIDENTIAL</p></body> 53</html>