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 http-equiv="Content-Style-Type" content="text/css">
7<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 8.0.0.0 for Windows">
8
9<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
10
11	<TITLE>MEMAllocFromExpHeap</TITLE>
12
13</HEAD>
14
15
16<BODY>
17
18<H1>MEMAllocFromExpHeap</H1>
19
20<H2>Syntax</H2>
21<DL><DD><PRE class="definition">
22#include &lt;revolution/mem.h&gt;
23
24void* MEMAllocFromExpHeap(
25    		MEMHeapHandle    heap,
26    		u32              size );
27</PRE></DD></DL>
28
29<H2>Arguments</H2>
30<TABLE class="arguments" border="1">
31  <TR>
32<TH><STRONG><EM><CODE>heap</CODE></EM></STRONG></TH>
33<TD>Expanded heap handle</TD>
34  </TR>
35  <TR>
36<TH>size</TH>
37<TD>Size of the memory block in bytes</TD>
38  </TR>
39</TABLE>
40
41<H2>Return Values</H2>
42<P>When the memory block is allocated, the start address of this memory block is returned. When memory cannot be allocated, <CODE>NULL</CODE> is returned.</P>
43
44<H2>Description</H2>
45<P>Allocates a memory block from the expanded heap. The memory block has an alignment of 4.</P>
46<P>If the memory block is allocatable, the actual size of the memory block may be greater than the specified size. To determine the actual allocated size in bytes, use the <A href="MEMGetSizeForMBlockExpHeap.html"><CODE>MEMGetSizeForMBlockExpHeap</CODE></A> function.</P>
47
48<H2>See Also</H2>
49<P class="reference">
50<A href="MEMAllocFromExpHeapEx.html">MEMAllocFromExpHeapEx</A>,
51<A href="MEMFreeToExpHeap.html">MEMFreeToExpHeap</A>,
52<A href="MEMCreateExpHeap.html">MEMCreateExpHeap</A>,
53<A href="MEMCreateExpHeapEx.html">MEMCreateExpHeapEx</A>
54</P>
55
56<H2>Revision History</H2>
57<P>
582006/03/01 Initial version.<BR>
59</P>
60
61<hr><p>CONFIDENTIAL</p></body>
62</HTML>
63