V86MMGR_GetPgStatus

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 version 3.1 and later.

Parameters

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_EMM Page belongs to EMM driver.
V86PS_MAP Page belongs to mapper.
V86PS_UMB Page is part of a UMB.
V86PS_XMS Page belongs to XMS driver.

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