[Toc][Index]

DosSubAlloc


Bindings:  C, MASM 

This call suballocates portions of a segment allocated by DosAllocSeg or 
DosAllocShrSeg, and initialized by  DosSubSet. 
 DosSubAlloc     (SegSelector, BlockOffset, Size) 
 
 SegSelector (SEL) - input 
    Data segment selector that allocates the memory. 
 BlockOffset (PUSHORT) - output 
    Address of the allocated block offset. 
 Size (USHORT) - input 
    Memory block size requested in bytes. 
 
 rc (USHORT) - return 
    Return code descriptions are: 
    0         NO_ERROR 
    311       ERROR_DOSSUB_NOMEM 
    313       ERROR_DOSSUB_BADSIZE 
 
 Remarks 
 Before a segment allocated by DosAllocSeg or DosAllocShrSeg can be 
 suballocated, it must first be initialized for suballocation by a call to 
 DosSubSet. 
 Allocation size must be a multiple of four bytes.  Otherwise, it is 
 rounded up to a multiple of four bytes. The maximum value for the size 
 parameter is the size that was set with DosSubSet minus 8. Note that no 
 paragraph (16-byte) alignment is required; all requests are serviced on a 
 byte alignment basis. 
 A suballocated block of memory in a suballocated segment is freed by a 
 call to DosSubFree. 

Created using Inf-PHP v.2 (c) 2003 Yuri Prokushev
Created using Inf-HTML v.0.9b (c) 1995 Peter Childs