Debug_Out

include debug.inc

Debug_Out String
Debug_Out String, level

Writes the specified string to the debugging device, and halts in the debugger if a debugger is attached.

• No return value.

String

String to display. The string must be enclosed in double quotation marks. The string can contain register placeholders in the same forms as described for the Out_Debug_String service.

level

Optional symbol indicating the debugging level for which code should be generated. If the value of the Deblevel symbol is greater than or equal to level, then code is generated. Otherwise, code is not generated. The symbol can be DeblevelNormal or DeblevelMax. The default is DeblevelNormal.

Additional macros exist, such as Debug_OutX, where X is a conditional jump type, i.e., something that can follow the letter j to form a conditional jump instruction. In such case, the debug-out is performed only if the condition is satisfied.

Examples:

; The following message is printed only if Deblevel  Deblevelmax
Debug_Out "Error!  Mumble mumble", Deblevelmax
cmp    nFrobs, 5
Debug_OutA "Error! More than 5 frobs!"

cmp [esi].dwSignature, 31415927h
Debug_OutNZ "Error!  Invalid signature!"

The assembler generates code for the macro only if the constant DEBUG is defined before including the DEBUG.INC file.

See also Out_Debug_String, Test_Debug_Installed