1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.1.0 for Windows">
6<META http-equiv="Content-Style-Type" content="text/css">
7<TITLE>OS_JumpToSystemMenu</TITLE>
8<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
9</HEAD>
10<BODY>
11<H1 align="left">OS_JumpToSystemMenu <img src="../../image/TWL.gif" align="middle"></H1>
12<H2>Syntax</H2>
13<DL>
14<DD><CODE>#include &lt;nitro/os.h&gt;</CODE><BR> <BR> <code>BOOL OS_JumpToSystemMenu( void );</CODE>
15</DL>
16<H2>Arguments</H2>
17<P>None.</P>
18<H2>Return Values</H2>
19<P>Returns FALSE if running in NITRO mode.<BR><font color="#ff0000"><B>If running in TWL mode, this function normally succeeds but control is not returned.</B></font></P>
20<H2>Description</H2>
21<P>Performs a hardware reset and returns to the System Menu.</P>
22<P><font color="#ff0000"><B>This function cannot be called when interrupts are disabled. <BR>Because this function cannot be called during the exit process either, take care that it is not executed from within an exit callback registered using functions such as the <A href="../../spi/pm/PM_AppendExitCallback.html"><CODE>PM_Append*ExitCallback</CODE></A> functions.</B></font></P>
23
24<P>The <A href="../../spi/pm/PM_ForceToResetHardware.html"><CODE>PM_ForceToResetHardware</CODE></A>function is used internally by this function. Making a direct call to the <CODE><A href="../../spi/pm/PM_ForceToResetHardware.html">PM_ForceToResetHardware</A></CODE> function also returns the process to the System Menu. TWL has a mechanism to write parameters at the beginning of main RAM, thus enabling you to change the initial process after a hardware reset. If an unintended value is written to this parameter, the call to <CODE><A>PM_ForceToResetHardware</A></CODE> may not return the process to the System Menu. <FONT color="#ff0000">Because of this possibility, use the <CODE>OS_JumpToSystemMenu</CODE> function to return to the System Menu.</FONT></P>
25<H2>See Also</H2>
26<P><A href="../../spi/pm/PM_ForceToResetHardware.html"><CODE>PM_ForceToResetHardware</CODE></A><BR> <A href="../../spi/pm/PM_AppendExitCallback.html"><CODE>PM_Append*ExitCallback</CODE></A><BR> <A href="../../spi/pm/PM_AppendExitCallback.html"><CODE>PM_Prepend*ExitCallback</CODE></A><BR> <A href="../../spi/pm/PM_AppendExitCallback.html"><CODE>PM_Insert*ExitCallback</CODE></A></P>
27<H2>Revision History</H2>
28<P>2008/10/22 Added the fact that execution during exit processing is prohibited.<BR> 2008/09/08 Revised the icon.<BR> 2008/08/05 Initial version.</P>
29<hr><p>CONFIDENTIAL</p></body>
30</HTML>