PATH ADC Home > Documentation > Hardware > Device Managers and Drivers > PCI Card Services > Designing PCI Cards and Drivers for Power Macintosh Computers

PoolAllocateResident



 
void PoolAllocateResident(

                     ByteCount byteSize,

                     Boolean clear);

--> byteSize: The number of bytes of memory to allocate.
--> clear: Whether or not the allocated memory is to be zeroed.

DESCRIPTION

The PoolAllocateResident function allocates resident memory byteSize in length. The memory address is returned as the result of the call. A nil result indicates that the pool is exhausted.

EXECUTION CONTEXT

PoolAllocateResident may be called only from task level, not from secondary or hardware interrupt level.

RESULT CODES

`noErr`	0	No error
`qErr`	-1	Queue element not found
`memFullErr`	-108	Not enough room in heap