Carbon


LockMemory

Header: MacMemory.h Carbon status: Unsupported

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

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

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

count

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

function result

A result code. A result code.

DISCUSSION

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

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)