Carbon


DebuggerLockMemory

Header: MacMemory.h Carbon status: Unsupported

Makes a portion of the address space immovable in physical memory and ineligible for paging while leaving data caching enabled on the affected pages.

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

A pointer indicating the start address of the range of memory that is to be locked in RAM.

count

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

function result

A result code. A result code.

DISCUSSION

The DebuggerLockMemory function works like the LockMemory function as it locks a portion of the address space. DebuggerLockMemory also leaves data caching enabled on the affected pages.

If the starting address you supply to the DebuggerLockMemory function is not on a page boundary, then DebuggerLockMemory rounds down to the nearest page boundary. Similarly, if the specified range does not end on a page boundary, DebuggerLockMemory 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)