MEMUseMarginOfAlignmentForExpHeap

Syntax

#include <cafe/mem.h>

BOOL MEMUseMarginOfAlignmentForExpHeap( MEMHeapHandle heap, BOOL reuse );

Parameters

heap Expanded heap handle.
reuse TRUE to reuse the small memory fragments produced by alignment.
FALSE to not reuse. (Default is FALSE.)

Return Values

Returns the settings before the function was executed.

Description

Sets whether to reuse, as valid memory, the small memory fragments produced when memory was allocated after setting alignment with the MEMAllocFromExpHeapEx function.

If this setting is set to valid (TRUE) and a large amount of memory fragments are registered, performance may decrease drastically. Use of this function is recommended only when not allocating a large number of relatively small partitioned heaps or aligned memory spaces.

By default this is set to FALSE.

Do Not Call From

Callbacks Do not call this function from any callback function.

See Also

MEMAllocFromExpHeapEx

Revision History

2013-05-08 Automated cleanup pass.
2010-11-01 Initial version.


CONFIDENTIAL