Destroy_VM

include vmm.inc

mov     ebx, VMHandle
mov     eax, Destroy_VM
VMMCall System_Control
 

Notifies the virtual device that the system is about to destroy the virtual machine. Virtual devices typically remove any data associated with the specified virtual machine. The virtual device may use all general registers and flags.

• This message cannot be failed. The virtual device must return carry clear.

VMHandle

Handle of the virtual machine about to be destroyed.

The Destroy_VM message is sent to all virtual devices in initialization order.

The virtual device must not call the Simulate_Int or Exec_Int service in the specified virtual machine.

Considerable time can elapse between receipt of the VM_Not_Executeable message and this message. Once all virtual devices return from the Destroy_VM and Destroy_VM2 messages, the virtual machine is destroyed and the handle becomes invalid.

See Also

Create_VM, Destroy_VM2, VM_Not_Executeable