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=utf-8"> 5<META http-equiv="Content-Style-Type" content="text/css"> 6<META name="GENERATOR" content="Microsoft FrontPage 5.0"> 7<LINK rel="stylesheet" href="../../CSS/revolution.css" type="text/css"> 8<TITLE>OSSetSaveRegion</TITLE> 9</HEAD> 10<BODY> 11<H1>OSSetSaveRegion</H1> 12 13<H2>Syntax</H2> 14<dl><dd><pre class="construction"> 15#include <revolution/os.h> 16 17void OSSetSaveRegion( void* start, void* end ); 18</pre></dd></dl> 19 20<H2>Arguments</H2> 21<TABLE class="arguments" border="1" > 22 <TBODY> 23 <TR> 24<TH>start</TH> 25<TD>Start address of uncleared memory when the system is started using <A href="OSExec.html"><CODE>OSExecl</CODE></A>, <A href="OSExec.html"><CODE>OSExecv</CODE></A>, or <A href="OSRestart.html"><CODE>OSRestart</CODE></A>. Must be either at or above the address <CODE>0x8070_0000</CODE>, or <CODE>NULL</CODE>.</TD> 26 </TR> 27 <TR> 28<TH>end</TH> 29<TD>End address of uncleared memory when the system is started using <A href="OSExec.html"><CODE>OSExecl</CODE></A>, <A href="OSExec.html"><CODE>OSExecv</CODE></A>, or <A href="OSRestart.html"><CODE>OSRestart</CODE></A>. Must be either at or below the address <CODE>0x8120_0000</CODE>, or <CODE>NULL</CODE>.</TD> 30 </TR> 31 </TBODY> 32</TABLE> 33 34<H2>Return Values</H2> 35<P>None.</P> 36 37<H2>Description</H2> 38<P>Set the memory region that should not be cleared by calling <a href="../Init/OSInit.html"><code>OSInit</code></a> after <code><a href="OSExec.html">OSExecl</a></code>, <code><a href="OSExec.html">OSExecv</a></code>, or <A href="OSRestart.html"><CODE>OSRestart</CODE></A>. By default, <a href="../Init/OSInit.html"><code>OSInit</code></a> clears all the arena, but if you call this function, you can leave [<i><code>start</code></i>, <i><code>end</code></i>) uncleared. Be aware that this function only affects the <a href="../Init/OSInit.html"><code>OSInit</code></a> function after <code><a href="OSExec.html">OSExecl</a></code>, <code><a href="OSExec.html">OSExecv</a></code>, or <A href="OSRestart.html"><CODE>OSRestart</CODE></A>.</P> 39<P>[ <SPAN class="argument">start</SPAN>, <SPAN class="argument">end</SPAN>) must be included in the area [MAX(0x8070_0000, program size), 0x8120_0000]. (That is, <SPAN class="argument">start</SPAN> must be greater than or equal to either 0x8070_0000 or [0x8070_0000 + program size], and <SPAN class="argument">end</SPAN> must be less than or equal to 0x8120_0000. ) If both are specified to be <CODE>NULL</CODE>, the default action will be taken. In other words, the <A href="../Init/OSInit.html"><CODE>OSInit</CODE></A> function will clear all arenas.</P> 40 41<P> 42<B>Note:</B> A memory region of 32 bytes or larger must be specified for <CODE>OSSetSaveRegion</CODE>. It is not necessary to align to 32 bytes.<br>This function does not support NAND applications. 43 44</P> 45 46<H2>See Also</H2> 47<P class="reference"> 48<A href="OSExec.html"><CODE>OSExecl</CODE></A>/<A href="OSExec.html"><CODE>OSExecv</CODE></A><BR><A href="OSRestart.html"><CODE>OSRestart</CODE></A><BR><A href="OSGetSaveRegion.html"><CODE>OSGetSaveRegion</CODE></A><BR><A href="OSGetSavedRegion.html"><CODE>OSGetSavedRegion</CODE></A> 49</P> 50 51<H2>Revision History</H2> 52<P> 532009/07/13 Explained that NAND applications are not supported.<BR>2008/05/13 Added mention of the restriction on the memory region size that can be specified.<BR>2008/05/12 Added mention of effective function information.<BR>2006/03/01 Initial version.<br> 54</P> 55 56<hr><p>CONFIDENTIAL</p></body> 57</HTML>