include dosmgr.inc VxDcall _DOSMGR_Exec_VM <VM, V86Size, CallBack, RefData> |
The _DOSMGR_Exec_VM service schedules the execution specified by a
previous call to the _DOSMGR_Set_Exec_VM_Data service, and sets other
parameters of the execution.
VM
Specifies the handle of the current virtual machine.
V86Size
Specifies the size in pages of the virtual machine. This is equal to the number of pages mapped using the MapIntoVM service starting at the first page in 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
Specifies the callback procedure to call when the virtual machine terminates. If this parameter is zero, no callback is called.
RefData
Specifies reference data to pass to the callback procedure.
This service has no return value.
The system calls the callback when the virtual machine terminates. The callback receives the following input parameters:
EBP ; points to a Client_Reg_Struc
EBX ; virtual machine handle
EDX ; points to reference data
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.