_Add_Global_V86_Data_Area

include vmm.inc

VMMCall _Add_Global_V86_Data_Area, <LinAddr, nBytes, flags>

or      eax, eax        ; nonzero if added, zero if error
jz      not_added
 

Adds a region to the list of regions available for allocation as global V86 data areas. This service is only available during initialization, and only for Windows version 3.1 or later. Uses EAX, ECX, EDX, Flags.

• Returns a nonzero value in the EAX register if successful, zero otherwise.

LinAddr

Linear address of the first byte of the region. This address must be less than 100000h, and must not lie between the first and last V86 page for the specified virtual machine.

nBytes

Size of the region, in bytes.

flags

Operation flags. Must be zero.

This service supports virtual devices, such as the virtual MS-DOS manager and the V86MMGR device, which can manage high memory above the last V86 page. The service lets these devices add available regions that would otherwise go unused. Typically, such regions are non-page-aligned fragments that cannot be used for normal operations requiring page-aligned memory.

Calls to this service should be made during processing of the Sys_Critical_Init message. Virtual devices should not wait for the Device_Init or Init_Complete messages because most of the allocation of global V86 data areas is done while processing the Device_Init message.

If this service adds a region that is above the last V86 page, virtual devices should not attempt to allocate the region until the Sys_Critical_Init message has been processed.

See Also

_Allocate_Global_V86_Data_Area