DevHelp InternalError

This service is called when an internal inconsistency has been detected.

Syntax

C

USHORT APIENTRY DevHelp_InternalError( PSZ MsgText, USHORT MsgLength );

Assembler

LDS   SI, message_text
MOV   DI, message_text_length
MOV   DL, DevHlp_InternalError
CALL  [Device_Help]

Parameters

C

MsgText (PSZ)

Pointer to the message text

MsgLength (USHORT)

Length of the message text.

Assembler

LDS   SI, message_text
MOV   DI, message_text_length
MOV   DL, DevHlp_InternalError
CALL  [Device_Help]

Return Code

C

Success Indicator: None.

Possible errors: None.

Assembler

This routine does not return to the caller.

Remarks

This function is used only when an internal inconsistency is detected. In this situation, the system might be unable to continue safely. This should be used only when the operation of the system is questionable. A non-critical device driver (Parallel Port, COM, or other) might never use this routine.

The maximum message length is 128 characters. Longer messages are truncated. The message display code is limited. The message should contain ASCII characters in the range 0x20 through 0x7E, with optional 0x0D and 0x0A to break the text into multiple lines. The physical device driver name must preface the message text.

Example Code

C

#include  "dhcalls.h"

USHORT APIENTRY DevHelp_InternalError( PSZ    MsgText,
                                       USHORT MsgLength );