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>OSAddToHeap</title>
10</head>
11
12<body>
13
14<h1>OSAddToHeap</h1>
15
16
17<h2>C Specification</h2>
18
19<dl>
20<dd><pre><CODE>#include &lt;revolution/os.h&gt;</CODE></pre></dd>
21<dd><pre>void OSAddToHeap (OSHeapHandle heap, void* start, void* end);
22</CODE></pre></dd>
23</dl><h2>Arguments</h2>
24<TABLE border="1" cellpadding="3" cellspacing="0.1">
25  <tr>
26<TD width="120" bgcolor="#ffffe8"><em><strong><code><STRONG><EM><CODE>heap</CODE></EM></STRONG></code></strong></em></TD>
27<TD width="520">Operating heap handle that was previously created using the <a href="OSCheckHeap.html"><code>OSCreateHeap</code></a> function.</TD>
28    </tr>
29  <tr>
30<TD width="120" bgcolor="#ffffe8"><em><strong><code><STRONG><EM><CODE>size</CODE></EM></STRONG></code></strong></em></TD>
31<TD width="520">Start address of block to add to <strong><em><code>heap</code></em></strong>.</TD>
32    </tr>
33  <tr>
34<TD width="120" bgcolor="#ffffe8"><em><strong><code><STRONG><EM><CODE>end</CODE></EM></STRONG></code></strong></em></TD>
35<TD width="520">End address of block to add to <strong><em><code>heap</code></em></strong>.</TD>
36    </tr>
37</TABLE>
38<h2>Return Values</h2>
39
40<p>None.</p>
41<H2>Description</H2>
42<P>Although this function is provided for compatibility's sake, we recommend using the MEM library.  </P>
43
44
45
46<P>Adds an arbitrary memory block to <strong><em><code>heap</code></em></strong>. This function is used to free blocks previously allocated using the <code><a href="OSAllocFixed.html">OSAllocFixed</a></code> function or to create noncontiguous heaps.</P>
47
48
49
50<h2>See Also</h2>
51
52<p><a href="../list.html#Memory Allocation" target="contents">Memory Allocation Functions</a>, <code><a href="OSAllocFixed.html">OSAllocFixed</a></code>, <a href="OSCheckHeap.html"><code>OSCreateHeap</code></a></p>
53<H2>Revision History</H2>
54<P>03/01/2006 Initial version.</P>
55</body>
56</html>