Carbon


UnlockMemory

Header: MacMemory.h Carbon status: Unsupported

Undoes the effects of either LockMemory or LockMemoryContiguous.

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

A pointer indicating the starting address of the range of memory to be unlocked.

count

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

function result

A result code. A result code.

DISCUSSION

The UnlockMemory function makes a portion of the address space movable in physical memory and eligible for paging again.

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

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)