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.
Cancel_Priority_VM_Event
                                                     Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
include vmm.inc
 
mov     esi, Event              ; priority event handle
VMMcall Cancel_Priority_VM_Event
 
The Cancel_Priority_VM_Event service cancels an event that was previously
scheduled using the Call_Priority_VM_Event service. A virtual device must
not attempt to cancel an event if the callback procedure for the event has
already been called.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
Event      Specifies a handle identifying the event to cancel. This
           parameter can be zero to indicate that no event should be
           canceled.
 
Return Value
 
This service has no return value.
 
Comments
 
The event callback procedure typically sets the event handle to zero so that
subsequent calls by the virtual machine to this service do not cause
errors.
 
This service cancels any priority boost associated with the event even if
the PEF_Dont_Unboost value was specified when the event was scheduled.
 
Do not use this service to cancel events scheduled using the Call_VM_Event
or Schedule_VM_Event services. You must cancel virtual machine events using
the Cancel_VM_Event service.
 
Uses
 
Flags, ESI
 
See Also
 
Call_Priority_VM_Event