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.
Fatal_Error_Handler
                                                     Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
include vmm.inc
 
mov     esi, <MsgPtr>       ; points to message to display
mov     eax, <ErrFlags>     ; exit flags
VMMcall Fatal_Error_Handler
 
The Fatal_Error_Handler service terminates Windows by informing all
initialized virtual devices that is an unrecoverable error has occurred and
returning to real mode (optionally printing an error message). A virtual
device should call or jump to this service when it detects a fatal error.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
MsgPtr     Points to a zero-terminated string specifying the message to
           display. If this parameter is 0, no message is displayed.
 
ErrFlags   Specifies the exit flags. It can be a combination of the
           following values:
 
           Value            Meaning
           ─────────────────────────────────────────────────────────────────
           EF_Hang_On_Exit  Hangs the system on a fatal exit.
 
           All other values are reserved.
 
Return Value
 
This service does not return.
 
Uses
 
All registers
 
See Also
 
Fatal_Error, Fatal_Memory_Error