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_GetPgStatus
                                                     Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
include v86mmgr.inc
 
VxDcall V86MMGR_GetPgStatus
 
The V86MMGR_GetPgStatus service returns the status of a page. This service
allows the caller to discover various aspects of what a specific page is
being used for. This service can be called with any page number in the 0
through 110h range, but it is intended to return useful information only for
pages above the last V86 page.
 
This service is only available for Windows 3.1 and later.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
EBX        Specifies the virtual machine handle to get information for. If
           this parameter is zero, the service retrieves global
           information.
 
ECX        Specifies the V86 page number. It must be in the rage 0 through
           110h.
 
Return Value
 
The EAX register contains one or more of the following information values
for the page:
 
Value      Meaning
────────────────────────────────────────────────────────────────────────────
V86PS_MAP  Page belongs to mapper
 
V86PS_XMS  Page belongs to XMS driver
 
V86PS_EMM  Page belongs to EMM driver
 
V86PS_UMB  Page is part of a UMB
 
The V86PS_XMS value is not necessarily set.
 
Comments
 
One particular use of this service is to determine if a page is part of an
imported high memory UMB.
 
This service will not work if called during the Sys_Critical_Init message.
The service is not valid until the Device_Init message. Calls during
Device_Init only return useful information if paging import from a
LIMulator/UMBulator is performed. In cases where no paging import exists,
the information will not be correct until after the Init_Complete message.
 
Uses
 
EAX, Flags
 
                                      ♦