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	<!-- �^�C�g���� -->
12	<TITLE>MEMFreeToFrmHeap</TITLE>
13
14</HEAD>
15
16
17<BODY>
18
19
20<!-- �^�C�g���� -->
21<H1>MEMFreeToFrmHeap</H1>
22
23
24<H2>C Specification</H2>
25<PRE class="construction">#include &lt;revolution/mem.h&gt;
26
27void MEMFreeToFrmHeap( MEMHeapHandle heap, int mode );</PRE>
28
29
30<H2>Arguments</H2>
31<TABLE border="1">
32
33    <TR>
34	<TD><STRONG><EM><CODE>heap</CODE></EM></STRONG></TD>
35	<TD>Frame heap handle.</TD>
36</TR>
37    <TR>
38<TD><STRONG><EM><CODE>mode</CODE></EM></STRONG></TD>
39<TD>Memory block deallocation method (see below).</TD>
40    </TR>
41  </TABLE>
42
43
44<H2>Return Values</H2>
45<P>None.</P>
46
47
48<H2>Description</H2>
49<P>This function frees memory blocks in bulk. The deallocation method is set with <STRONG><EM><CODE>mode</CODE></EM></STRONG>. You can specify the following values for <STRONG><EM><CODE>mode</CODE></EM></STRONG>:</P>
50<TABLE border="1">
51
52    <TR>
53<TD><CODE>MEM_FRMHEAP_FREE_HEAD</CODE></TD>
54<TD>Frees memory block groups allocated from the bottom of the heap region.</TD>
55    </TR>
56    <TR>
57<TD><CODE>MEM_FRMHEAP_FREE_TAIL</CODE></TD>
58<TD>Frees memory block groups allocated from the top of the heap region.</TD>
59    </TR>
60    <TR>
61<TD><CODE>MEM_FRMHEAP_FREE_ALL</CODE></TD>
62<TD>Simultaneously frees all allocated memory blocks from the heap. This function and setting <CODE>MEM_FRMHEAP_FREE_HEAD</CODE> and <CODE>MEM_FRMHEAP_FREE_TAIL</CODE> are at the same time are the same. </TD>
63    </TR>
64
65</TABLE>
66<H2>See Also</H2>
67<P class="reference"><A href="MEMAllocFromFrmHeap.html"><CODE>MEMAllocFromFrmHeap</CODE></A>, <A href="MEMAllocFromFrmHeapEx.html"><CODE>MEMAllocFromFrmHeapEx</CODE></A></P>
68<H2>Revision History</H2>
69<P>03/01/2006 Initial version.</P>
70
71
72</BODY>
73</HTML>
74