Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                     ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
include v86mmgr.inc
 
VxDcall V86MMGR_Allocate_V86_Pages
 
The V86MMGR_Allocate_V86_Pages service allocates and maps the base V86
memory for a virtual machine.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
EBX        Specifies the virtual machine handle.
 
ESI        Specifies the desired size of virtual machine address space in
           kilobytes.
 
EDI        Specifies the minimum size of virtual machine address space in
           kilobytes.
 
ECX        Specifies the flags. See the V86MMGR.INC file for bit
           definitions.
 
Return Value
 
The carry flag is clear if the service allocates memory and maps it into the
virtual machine. The EAX register contains the actual number of pages
allocated and mapped (that is, the size of the virtual machine). This size
does not include the space from 0 to the first virtual machine page.
 
If the carry flag is set, the service could not allocate memory.
 
Comments
 
On an error, this service calls the GetSetDetailedVMError service to set an
error value.
 
The sizes specified by the ESI and EDI parameters include the region of V86
address space from 0 through the first virtual machine page.
 
Uses
 
EAX, Flags
 
                                      ♦