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.0.0 for Windows"> 6<META http-equiv="Content-Style-Type" content="text/css"> 7<TITLE>OS_AllocFrom*ArenaLo</TITLE> 8<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css"> 9</HEAD> 10<BODY> 11<H1 align="left">OS_AllocFrom*ArenaLo <IMG src="../../image/NTR.gif" align="middle"><IMG src="../../image/TWL.gif" align="middle"></H1> 12<H2>Syntax</H2> 13<DL> 14 <DD> 15 <PRE><CODE>#include <nitro/os.h></CODE></PRE> 16 <PRE><CODE>void* OS_AllocFromArenaLo( OSArenaId id, u32 size, u32 alignment );</CODE> 17 18<CODE>void* OS_AllocFromMainArenaLo( u32 size, u32 alignment ); 19void* OS_AllocFromSubPrivArenaLo( u32 size, u32 alignment ); 20void* OS_AllocFromMainExArenaLo( u32 size, u32 alignment ); 21void* OS_AllocFromITCMArenaLo( u32 size, u32 alignment ); 22void* OS_AllocFromDTCMArenaLo( u32 size, u32 alignment ); 23void* OS_AllocFromSharedArenaLo( u32 size, u32 alignment ); 24void* OS_AllocFromWramMainArenaLo( u32 size, u32 alignment ); 25void* OS_AllocFromWramSubArenaLo( u32 size, u32 alignment ); 26void* OS_AllocFromWramSubPrivArenaLo( u32 size, u32 alignment );</CODE></PRE> 27</DL> 28<H2>Arguments</H2> 29<TABLE border="1" width="100%"> 30 <TBODY> 31 <TR> 32 <TD width="13%"><EM><STRONG>id</STRONG></EM></TD> 33 <TD width="87%">Arena ID</TD> 34 </TR> 35 <TR> 36 <TD><B><I>size</I></B></TD> 37 <TD>Size to be reserved</TD> 38 </TR> 39 <TR> 40 <TD><B><I>alignment</I></B></TD> 41 <TD>Alignment specification for the region's start address</TD> 42 </TR> 43 </TBODY> 44</TABLE> 45<H2>Return Values</H2> 46<P>The start address of the reserved region.</P> 47<H2>Description</H2> 48<P>This function reserves a region from the bottom of an arena. <em><strong><code>id</code></strong></em> specifies an arena using an arena ID. For details on arena ID see <A href="OS_InitArena.html"><code>OS_InitArena()</code></A>. For details on arena ID, see <a href="../arena/OS_InitArena.html"><code>OS_InitArena()</code></a>. <EM><STRONG><CODE>size</CODE></STRONG></EM> specifies the size to be reserved in bytes. <EM><STRONG><CODE>alignment</CODE></STRONG></EM> specifies alignment for the reserved region. After the region is reserved, the arena's lower boundary address will be changed by the size of the region that was taken. Because no upward boundary check is performed, problems will occur if a region larger than the arena is reserved.</P> 49<P><CODE>OS_AllocFromMainArenaLo</CODE> is the inline function for <CODE>OS_AllocFromArenaLo( OS_ARENA_MAIN, ...</CODE>.<BR><CODE>OS_AllocFromSubPrivArenaLo</CODE> is the inline function for <CODE>OS_AllocFromArenaLo( OS_ARENA_MAIN_SUBPRIV, ...</CODE>.<BR><CODE>OS_AllocFromMainExArenaLo</CODE> is the inline function for <CODE>OS_AllocFromArenaLo( OS_ARENA_MAINEX, �E)</CODE>.<BR><CODE>OS_AllocFromITCMArenaLo</CODE> is the inline function for <CODE>OS_AllocFromArenaLo( OS_ARENA_ITCM, �E)</CODE>.<BR><CODE>OS_AllocFromDTCMArenaLo</CODE> is the inline function for <CODE>OS_AllocFromArenaLo( OS_ARENA_DTCM, �E)</CODE>.<BR><CODE>OS_AllocFromSharedArenaLo</CODE> is the inline function for <CODE>OS_AllocFromArenaLo( OS_ARENA_SHARED, �E)</CODE>.<BR><CODE>OS_AllocFromWramMainArenaLo</CODE> is the inline function for <CODE>OS_AllocFromArenaLo( OS_ARENA_WRAM_MAIN, �E)</CODE>.<BR><CODE>OS_AllocFromWramSubArenaLo</CODE> is the inline function for <CODE>OS_AllocFromArenaLo( OS_ARENA_WRAM_SUB, �E)</CODE>.<BR><CODE>OS_AllocFromWramSubPrivArenaLo</CODE> is the inline function for <CODE>OS_AllocFromArenaLo( OS_ARENA_WRAM_SUBPRIV, �E)</CODE>.</P> 50<H2>See Also</H2> 51<P><CODE><A href="OS_InitArena.html">OS_InitArena</A>, <A href="OS_AllocFromArenaHi.html">OS_AllocFromArenaHi</A><BR></CODE></P> 52<H2>Revision History</H2> 53<P>2004/02/19 Changed the number of arenas from 6 to 9.<BR>2004/01/06 Initial version.</P> 54<hr><p>CONFIDENTIAL</p></body> 55</HTML>
