V86MMGR_SetAvailMapPgs

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

Parameters

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 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