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.
_DeAssign_Device_V86_Pages
                                                     Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
include vmm.inc
 
VMMcall _DeAssign_Device_V86_Pages, <VMLinrPage, nPages, VM, flags>
 
or      eax, eax        ; nonzero if unassigned, zero if error
jz      not_unassigned
 
The _DeAssign_Device_V86_Pages service unassigns a region in the V86 address
space which was previously assigned using the _Assign_Device_V86_Pages
service.
 
Parameter   Description
────────────────────────────────────────────────────────────────────────────
 
VMLinrPage  Specifies the linear page number of the first page to unassign.
            The page number must be in the range 0 through 10Fh.
 
nPages      Specifies the number of pages to unassign. All pages to unassign
            must be within the V86 address space. If any a page is not
            assigned, this service returns an error value.
 
VM          Specifies a handle identifying a virtual machine. If this
            parameter is a valid handle, the service unassigns pages
            previously assigned to the virtual machine. If this parameter is
            zero, the service unassigns pages that were previously assigned
            to all virtual machines.
 
flags       Specifies the operation flags. This parameter must be set to 0.
 
Return Value
 
The EAX register contains a nonzero value if the service was successful.
Otherwise, EAX contains zero to indicate an error such as a page in the
range already unassigned or an invalid page range.
 
Comments
 
This service only works after device initialization is complete.
 
A virtual device must not attempt to unassign pages that have not yet been
assigned, or attempt to globally unassign pages that were only locally
assigned.
 
Uses
 
EAX
 
See Also
 
_Assign_Device_V86_Pages