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.
Resume_VM
                                                     Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
include vmm.inc
 
mov     ebx, VM         ; VM handle
VMMcall Resume_VM
 
jc      not_resumed     ; carry set if virtual machine not resumed
 
The Resume_VM service resumes the execution of a virtual machine previously
suspended by the Suspend_VM service.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
VM         Specifies a handle identifying the virtual machine to resume.
 
Return Value
 
The carry flag is clear if the suspend count is zero and the virtual machine
is in the ready-processes queue. The carry flag is clear to indicate an
error.
 
Comments
 
This service decrements the suspend count and places the virtual machine in
the ready-processes queue if the new count is zero. The system carries out a
task switch to the resumed virtual machine if the virtual machine has a
higher priority than the current virtual machine.
 
An error can occur if a virtual device cannot lock the memory handles for
the specified virtual machine. The system notifies every virtual device of
the request to resume a virtual machine, and any virtual device can deny the
request. In such cases, this service returns with the carry flag set and the
virtual machine remains suspended with a suspend count of 1.
 
Uses
 
Flags
 
See Also
 
No_Fail_Resume_VM, Suspend_VM