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>MEMUseMarginOfAlignmentForExpHeap</TITLE> 12 13</HEAD> 14 15 16<BODY> 17 18 19<H1>MEMUseMarginOfAlignmentForExpHeap</H1> 20 21 22<H2>Syntax</H2> 23<PRE class="construction">#include <revolution/mem.h> 24 25BOOL MEMUseMarginOfAlignmentForExpHeap( MEMHeapHandle heap, BOOL reuse );</PRE> 26 27 28<H2>Arguments</H2> 29<TABLE border="1"> 30 31 <TR> 32 <TD>heap</TD> 33 <TD>Expanded heap handle</TD> 34</TR> 35 <TR> 36<TD>reuse</TD> 37<TD><CODE>TRUE</CODE> to reuse the small memory fragments produced by alignment.<BR><CODE>FALSE</CODE> to not reuse. (Default is <CODE>FALSE</CODE>.) 38 </TD> 39 </TR> 40 </TABLE> 41 42 43<H2>Return Values</H2> 44 45<P>Returns the settings before the function was executed.</P> 46 47<H2>Description</H2> 48 49<P>Sets whether to reuse, as valid memory, the small memory fragments produced when memory was allocated after setting alignment with the <A href="MEMAllocFromExpHeapEx.html"><CODE>MEMAllocFromExpHeapEx</CODE></A> function.</P> 50<P>Be aware that if this setting is set to valid (<CODE>TRUE</CODE>) and a large amount of memory fragments are registered, performance may decrease drastically. Use of this function is recommended only when you are sure you will not be allocating a great number of relatively small partitioned heaps or aligned memory spaces.</P> 51<P>By default this is set to <CODE>FALSE</CODE>.</P> 52<H2>See Also</H2> 53<P class="reference"><A href="MEMAllocFromExpHeapEx.html">MEMAllocFromExpHeapEx</A></P> 54 55 56<H2>Revision History</H2> 57<P>2007/08/10 Initial version.</P> 58 59 60<hr><p>CONFIDENTIAL</p></body> 61</HTML> 62