Virtual Devices (3.1) (vdag31qh.hlp) (Table of Contents; Topic list)
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.
V86MMGR_SetAvailMapPgs
                                                     Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
include v86mmgr.inc
 
VxDcall V86MMGR_SetAvailMapPgs
 
The V86MMGR_SetAvailMapPgs service relinquishes regions above the last V86
page to the V86MMGR's mapper services for use as a mapper region.
 
This service is only available for Windows 3.1 and later.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
EAX        Specifies the starting page number of the region.
 
ECX        Specifies the size of the region in pages.
 
Return Value
 
The carry flag is clear if the service adds the region. Otherwise, the carry
flag is set to indicate an error such as an invalid region.
 
Comments
 
Virtuals devices other than the V86MMGR (DOSMGR) can relinquish regions
above the last V86 page to the V86MMGR's mapper services for use as a mapper
region. These regions usually overlap with V86MMGR XMS UMB import pages, but
this is not required. A virtual device can hand over a page that it has
already marked as owned by the device in the Device_V86_Pages array. The
V86MMGR marks the page as one it owns (even though it did not actually do
the _Assign_Device_V86_Pages for it).
 
Once a region is relinquished, the virtual device must not attempt to access
it. it. These regions may only be marked as in-use by the V86MMGR XMS
driver. This happens when the region overlaps XMS UMB import pages.
 
This routine has a global effect, it does not take a virtual machine handle
argument.
 
Uses
 
Flags
 
                                      ♦