HoldMemory

HoldMemory Make part of the address space resident in memory

#include <Memory.h> Memory Manager

Debugger Support Under Virtual Memory

OSErr HoldMemory( address, count );

void * address is the start address of the memory range

unsigned long count is the size of the range

returns Error Code; 0=no error

The HoldMemory function makes a portion of the address space resident in

physical memory and ineligible for paging.

address is the start address of the range of memory that is to be held

in RAM

count is the size in bytes of that range.

Returns: an operating system Error Code.

noErr (0) No error

paramErr (-50) Error in parameter list

notEnoughMemoryErr (-620) Insufficient physical memory

interruptsMaskedErr (-624) Called with interrupts masked

Notes: If the starting address parameter supplied to the HoldMemory function is

not on a page boundary, then it is rounded down to the nearest page

boundary. Similarly, if the specified range does not end on a page boundary,

the count parameter is rounded up so that the entire range of memory is

held.

Referenced by (6):