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 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 more must be specified to <CODE>OSSetSaveRegion</CODE>. 32-byte alignment is not required. 43</P> 44 45<H2>See Also</H2> 46<P class="reference"> 47<A href="OSExec.html">OSExecl</A>/<A href="OSExec.html">OSExecv</A>, <A href="OSRestart.html"><CODE>OSRestart</CODE></A>, 48<A href="OSGetSaveRegion.html">OSGetSaveRegion</A>, 49<A href="OSGetSavedRegion.html">OSGetSavedRegion</A> 50</P> 51 52<H2>Revision History</H2> 53<P> 542008/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> 55</P> 56 57<hr><p>CONFIDENTIAL</p></body> 58</HTML>