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 name="GENERATOR" content="Microsoft FrontPage 5.0">
7<META http-equiv="Content-Style-Type" content="text/css">
8<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
9<title>OSAllocFromMEM1ArenaHi</title>
10</head>
11
12<body>
13
14<h1>OSAllocFromMEM1ArenaHi</h1>
15
16
17<h2>C Specification</h2>
18
19<dl>
20  <dd><pre><code>#include &lt;revolution/os.h&gt;</code></pre>
21  </dd>
22  <dd><pre><CODE>void* OSAllocFromMEM1ArenaHi(u32 size, u32 align);</CODE></pre>  <dd><pre><CODE>#define OSAllocFromArenaHi OSAllocFromMEM1ArenaHi</CODE></pre>   </dd>
23</dl>
24
25<h2>Arguments</h2>
26<TABLE border="1" cellpadding="3" cellspacing="0.1">
27  <tr>
28      <TD width="120" bgcolor="#ffffe8"><FONT face="Courier New"><EM><STRONG><STRONG><EM><CODE>size</CODE></EM></STRONG></STRONG></EM></FONT></TD>
29      <TD width="520">Size of object to allocate.</TD>
30    </tr>
31  <tr>
32      <TD width="120" bgcolor="#ffffe8"><FONT face="Courier New"><EM><STRONG><STRONG><EM><CODE>align</CODE></EM></STRONG></STRONG></EM></FONT></TD>
33      <TD width="520">Object alignment and new arena boundary to set (must be a power of 2).</TD>
34    </tr>
35</TABLE>
36<h2>Return Values</h2>
37
38<P>A pointer to the allocated region that is aligned to an <STRONG><EM><CODE>align</CODE></EM></STRONG>-byte boundary. The new upper boundary of the arena is also set and aligned to an <STRONG><EM><CODE>align</STRONG></EM></FONT>-byte boundary.</P>
39<H2>Description</H2>
40<P>Allocates <STRONG><EM><CODE>size</CODE></EM></STRONG> bytes from the upper boundary of the arena in internal main memory (MEM1 area). Extra memory from the arena may be consumed for the alignment (specified by <STRONG><EM><CODE>align</CODE></EM></STRONG>).</P>
41
42<P>To maintain backward compatibility, it is also defined with the name <code>OSAllocFromArenaHi</code>. </P>
43
44<h2>See Also</h2>
45
46<p><a href="../toc.html#Arena" target="contents"><CODE>Arena Functions</CODE></a>, <a href="OSAllocFromMEM1ArenaLo.html"><code>OSAllocFromMEM1ArenaLo</code></a>, <a href="OSAllocFromMEM2ArenaHi.html"><code>OSAllocFromMEM2ArenaHi</code></a>, <a href="OSAllocFromMEM2ArenaLo.html"><code>OSAllocFromMEM2ArenaLo</code></a></p>
47<H2>Revision History</H2>
48<P>2006/03/01 Initial version.</P>
49<hr>
50<P>CONFIDENTIAL</p>
51</BODY>
52</HTML>