Legacy Document

Inside Macintosh: Memory /

Chapter 2 - Memory Manager / Memory Manager Reference

Memory Manager Routines

Managing Relocatable Blocks

The Memory Manager provides routines that allow you to purge and later reallocate space for relocatable blocks, recreate handles to relocatable blocks if you have access to their master pointers, and control where in their heap zone relocatable blocks are located.

To free the memory taken up by a relocatable block without releasing the master pointer to the block for other uses, use the EmptyHandle procedure. To reallocate space for a handle that you have emptied or the Memory Manager has purged, use the ReallocateHandle procedure.

If, because you have dereferenced a handle, you no longer have access to it but do
have access to its master pointer, you can use the RecoverHandle function to recreate the handle.

To ensure that a relocatable block that you plan to lock for short or long periods of time does not cause heap fragmentation, use the MoveHHi and the ReserveMem procedures, respectively.

---

Subtopics

EmptyHandle

ReallocateHandle

RecoverHandle

ReserveMem

ReserveMemSys

MoveHHi

HLockHi