OSSetCurrentHeap

C Specification

#include <revolution/os.h>
OSHeapHandle OSSetCurrentHeap (OSHeapHandle heap);

Arguments

heap Heap handle that was returned from the OSCreateHeap function.

Return Values

Previous heap handle.

Description

Although this function is provided for compatibility's sake, we recommend using the MEM library.

Sets heap as the current heap. After the OSAlloc and OSFree functions are called, all following calls will be performed on this heap unless the OSSetCurrentHeap function is called again.

See Also

Memory Allocation Functions, OSAlloc, OSFree

Revision History

03/01/2006 Initial version.