Virtual Devices (3.1) (vdag31qh.hlp) (Table of Contents; Topic list)
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.
_DOSMGR_Exec_VM
                                                     Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
include dosmgr.inc
 
VxDcall _DOSMGR_Exec_VM <VM, V86Size, CallBack, RefData>
 
The _DOSMGR_Exec_VM service schedules the execution specified by previous
call to the _DOSMGR_Set_Exec_VM_Data service and sets other parameters of
the execution.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
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.
 
CallBk     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.
 
Return Value
 
This service has no return value.
 
Comments
 
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.
 
                                      ♦