Important: The information in this document is obsolete and should not be used for new development.
PBAllocContig
You can use thePBAllocContig
function to allocate additional contiguous blocks to an open file.
FUNCTION PBAllocContig (paramBlock: ParmBlkPtr; async: Boolean): OSErr;
paramBlock
- A pointer to a basic File Manager parameter block.
async
- A Boolean value that specifies asynchronous (
TRUE
) or synchronous (FALSE
) execution.
--> ioCompletion
ProcPtr
A pointer to a completion routine. <-- ioResult
OSErr
The result code of the function. --> ioRefNum
Integer
A file reference number. --> ioReqCount
LongInt
The number of bytes requested. <-- ioActCount
LongInt
The number of bytes allocated, rounded up to the nearest multiple
of the allocation block size.DESCRIPTION
ThePBAllocContig
function is identical to thePBAllocate
function except that if there isn't enough contiguous empty space on the volume to satisfy the allocation request,PBAllocContig
does nothing and returnsdskFulErr
as its function result. If you want to allocate whatever space is available, even when the entire request cannot be filled by the allocation of a contiguous piece, callPBAllocate
instead.ASSEMBLY-LANGUAGE INFORMATION
The trap macro forPBAllocContig
is_AllocContig
.RESULT CODES