Important: The information in this document is obsolete and should not be used for new development.
SetGrowZone
To specify a grow-zone function for the current heap zone, pass a pointer to that function to theSetGrowZone
procedure. Ordinarily, you call this procedure early in the execution of your application.If you initialize your own heap zones besides the application and system zones, you can alternatively specify a grow-zone function as a parameter to the
InitZone
procedure.
PROCEDURE SetGrowZone (growZone: ProcPtr);
growZone
- A pointer to the grow-zone function.
DESCRIPTION
TheSetGrowZone
procedure sets the current heap zone's grow-zone function as designated by thegrowZone
parameter. ANIL
parameter value removes any grow-zone function the zone might previously have had.The Memory Manager calls the grow-zone function only after exhausting all other avenues of satisfying a memory request, including compacting the zone, increasing its size (if it is the original application zone and is not yet at its maximum size), and purging blocks from it.
See "Grow-Zone Functions" on page 2-89 for a complete description of a grow-zone function.
ASSEMBLY-LANGUAGE INFORMATION
The registers on entry and exit forSetGrowZone
are
Registers on entry A0 Pointer to new grow-zone function
Registers on exit D0 Result code RESULT CODES
noErr 0 No error