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>MEMCreateFrmHeap</TITLE>
12
13</HEAD>
14
15
16<BODY>
17
18
19<H1>MEMCreateFrmHeap</H1>
20
21<H2>Syntax</H2>
22<DL><DD><PRE class="construction">
23#include &lt;revolution/mem.h&gt;
24
25MEMHeapHandle MEMCreateFrmHeap(
26                             void*  startAddress,
27                             u32    size );
28</PRE></DD></DL>
29
30<H2>Arguments</H2>
31<TABLE class="arguments" border="1">
32  <TR>
33<TH><STRONG><EM><CODE>startAddress</CODE></EM></STRONG></TH>
34<TD>Start address of the memory region to allocate to the heap</TD>
35  </TR>
36  <TR>
37<TH>size</TH>
38<TD>Size in bytes of the memory region allocated to the heap</TD>
39  </TR>
40</TABLE>
41
42<H2>Return Values</H2>
43<P>Returns the heap handle when a heap was successfully created. Returns <CODE>MEM_HEAP_INVALID_HANDLE</CODE> (a null value) if a heap could not be created.</P>
44
45<H2>Description</H2>
46<P>Creates the frame heap. The heap region is a memory region with size <SPAN class="argument">size</SPAN> and a start address specified by <SPAN class="argument">startAddress</SPAN>.</P>
47
48<H2>See Also</H2>
49<P class="reference">
50<A href="MEMCreateFrmHeapEx.html">MEMCreateFrmHeapEx</A>
51</P>
52
53<H2>Revision History</H2>
54<P>
552006/03/01 Initial version.<BR>
56</P>
57
58<hr><p>CONFIDENTIAL</p></body>
59</HTML>
60