_DOSMGR_Exec_VM

include dosmgr.inc
 
VxDcall _DOSMGR_Exec_VM <VMHandle, V86Size, CallBack, RefData>

Schedules the execution specified by a previous call to the _DOSMGR_Set_Exec_VM_Data service, and sets other parameters of the execution.

• No return value.

VMHandle

Handle of the current virtual machine.

V86Size

Size in pages of the virtual machine. This service does not map these pages; the value is simply used to set the MS-DOS size of the virtual machine.

CallBack

Callback procedure to call when the virtual machine terminates. If this parameter is zero, no callback is called.

RefData

Reference data to pass to the callback procedure.

The system calls the callback when the virtual machine terminates. The callback receives the following input parameters:

The callback must preserve the EBX, EBP, and segment registers. After the callback returns, the system carries out the normal virtual machine termination sequence. At this time, the virtual machine is still in a running state. The callback can delay termination by delaying its return. However, the callback must simulate interrupts into the virtual machine to keep the scheduler moving if it is holding termination.