Carbon


HoldMemory

Header: MacMemory.h Carbon status: Unsupported

Makes a portion of the address space resident in physical memory and ineligible for paging.

OSErr HoldMemory (
    void *address, 
    UInt32 count
);
address

A pointer indicating the starting address of the range of memory to be held in RAM.

count

The size, in bytes, of the range of memory to be held in RAM.

function result

A result code. A result code.

DISCUSSION

If the starting address you supply to the HoldMemory function is not on a page boundary, then HoldMemory rounds down to the nearest page boundary. Similarly, if the specified range does not end on a page boundary, HoldMemory rounds up the value you pass in the count parameter so that the entire range of memory is held.

Even though HoldMemory does not move or purge memory, you should not call it at interrupt time.

AVAILABILITY

Not supported in Carbon. Not available in CarbonLib, but available when InterfaceLib 7.1 or later is installed. Exported by InterfaceLib 7.1 and later.


© 2000 Apple Computer, Inc. — (Last Updated 4/6/2000)