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.

                                                     ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
include vmm.inc
 
mov     eax, TimeOut    ; milliseconds to wait before failing close
mov     ebx, VM         ; handle of VM to close
mov     ecx, Flags      ; action to take
VMMcall Close_VM
 
The Close_VM service attempts to close the virtual machine, allowing all
virtual devices an opportunity to clean up before the virtual machine
terminates.
 
This service is only available in Windows version 3.1 and later.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
TimeOut    Specifies the number of milliseconds the service must wait before
           calling the NukeVM service to force the virtual machine to
           close.
 
VM         Specifies a handle identifying the virtual machine to close.
 
Flags      Specifies whether to return to the caller while closing the
           virtual machine. This parameter can be a combination of the
           following values:
 
           Value              Meaning
           ─────────────────────────────────────────────────────────────────
           CVF_Continue_Exec  Return to the virtual machine after scheduling
                              the closing event even if the virtual machine
                              is being closed.
 
           All other values are reserved.
 
Return Value
 
This service has no return value.
 
Comments
 
Whenever possible, a virtual device should use this service instead of the
the Nuke_VM or Crash_Cur_VM service.
 
Uses
 
Flags
 
                                      ♦