Set_Global_Time_Out

include vmm.inc

mov     eax, Time                       ; number of milliseconds
mov     edx, RefData                    ; reference data
mov     esi, OFFSET32 TimeOutCallback   ; callback procedure
VMMCall Set_Global_Time_Out

mov     [TimeOut], esi                  ; time-out handle
 

Schedules a time-out to occur after the specified number of milliseconds has elapsed. 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. This is a signed DWORD. The maximum value is 0x7FFFFFFF.

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 when the specified number of milliseconds elapse. 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 current virtual machine. 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 current virtual machine.

The Tardiness parameter specifies the number of milliseconds that have elapsed since the actual time-out occurred. See Time-Out Callback Procedures for a description of this value.

See Also

Set_VM_Time_Out