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.

                                                     ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
include vmm.inc
 
mov     esi, OFFSET32 EventCallback ; points to callback procedure
mov     edx, OFFSET32 RefData       ; points to reference data
VMMcall Schedule_Global_Event
 
mov     [Event], esi                ; event handle
 
The Schedule_Global_Event service schedules a global event, which is an
event that does not require a specific virtual machine to process it. The
system calls the event callback procedure immediately before the returning
from the current interrupt. Since any virtual machine can process the event,
the system does not switch tasks before calling the procedure.
 
This is an asynchronous service.
 
Parameter      Description
────────────────────────────────────────────────────────────────────────────
 
EventCallback  Points to the callback procedure. See the Comments section
               for more information about the procedure.
 
RefData        Points to reference data to be passed to the event callback
               procedure.
 
Return Value
 
The ESI register contains the event handle. The handle can be used in a
subsequent call to the Cancel_Global_Event service to cancel the event.
 
Comments
 
The callback procedure can carry out any actions and use any VMM services.
The system calls the event callback procedure as follows:
 
mov     ebx, VM                 ; current VM handle
mov     edx, OFFSET32 RefData   ; points to reference data
mov     ebp, OFFSET32 crs       ; points to a Client_Reg_Struc
call    [EventCallback]
 
The VM parameter is a handle identifying the current virtual machine,
RefData points to reference data supplied by the virtual machine that
scheduled the event, and crs points to a Client_Reg_Struc structure
containing the contents of the virtual machine's registers.
 
The callback procedure can modify EAX, EBX, ECX, EDX, ESI, and EDI.
 
See Also
 
Call_Global_Event, Cancel_Global_Event
 
 
                                      ♦