Set_VM_Time_Out

include vmm.inc

mov     eax, Time                       ; number of milliseconds
mov     ebx, VMHandle                   ; VM handle
mov     edx, RefData                    ; reference data
mov     esi, OFFSET32 TimeOutCallback   ; callback procedure
VMMCall Set_VM_Time_Out

mov     [TimeOut], esi                  ; time-out handle

Schedules a time-out that occurs after the specified virtual machine has run for the specified length of time. The system calls the time-out callback procedure only after the virtual machine has run for Time milliseconds. Time that elapses while other virtual machines run is not counted. Uses ESI, Flags. This is an asynchronous service.

Returns the handle of the time-out in the ESI register if successful, zero if the time-out could not be scheduled.

Time: Number of milliseconds to wait before calling the time-out callback procedure.
VMHandle: Handle of the virtual machine.
RefData: Reference data to be passed to the callback procedure.
TimeOutCallback: Address of the callback procedure. For more information about the callback procedure, see below.

The system calls the time-out callback procedure after the virtual machine has run for the specified number of milliseconds. The system calls the procedure as follows:

mov     ebx, VMHandle       ; current VM handle
mov     ecx, Tardiness      ; number of milliseconds since time-out
mov     edx, RefData        ; reference data
mov     ebp, OFFSET32 crs   ; points to Client_Reg_Struc
call    [TimeOutCallback]

The VMHandle parameter is a handle specifying the virtual machine for which the time-out was scheduled. The RefData parameter specifies the reference data for the callback procedure, and the crs parameter points to a Client_Reg_Struc structure that contains the register values for the virtual machine.

The Tardiness parameter specifies the number of milliseconds that have elapsed since the actual time-out occurred. See Timing Query Services for more information about time-outs.

Set_VM_Time_Out

See Also