Close_VM

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.

Parameters

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 the following value

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 Nuke_VM or Crash_Cur_VM service.

Uses

Flags