AMX DESIGN XPRESS V 1.5 - PROGRAMMER GUIDE User's Guide download pdf (Page 41)

KwikNet Overview

DAK

Debug Mask

KwikNet maintains a public debug control variable, an unsigned integer named

kn_d/jointfilesconvert/291411/bgflags. The bits in this variable are used to determine which, if any, KwikNet

debug features are enabled at runtime. The bit masks KN_DBxxxxx used to access this

variable are defined in KwikNet header file KN_COMN.H.

If bit

KN_DBENABLE in variable kn_d/jointfilesconvert/291411/bgflags is set to 0, all logging of error messages

(warnings and fatal error) is disabled.

If bit KN_DBENABLE in variable kn_d/jointfilesconvert/291411/bgflags is set to 1, debug message logging is

enabled.

If logging is enabled and a warning or fatal message is logged (see Chapter 1.6), the

action taken depends on the state of the KN_DBHALT bit in variable kn_d/jointfilesconvert/291411/bgflags. If this

bit is set to

1, KwikNet will generate a programmed halt, entering into a permanent loop,

unconditionally calling its breakpoint procedure

kn_bphit().

If you have enabled a programmed halt, the debug halt bit KN_DBHALT will be set when

your KwikNet application is loaded into memory. Otherwise, it will be clear. The halt bit

is never altered by KwikNet.

You can dynamically alter bits KN_DBENABLE and KN_DBHALT in variable kn_d/jointfilesconvert/291411/bgflags to

enable and disable these debug features at runtime to best meet your debugging needs.

Note

Although the KwikNet variable kn_d/jointfilesconvert/291411/bgflags is always

present, its content will only have an effect if your

application has been linked with a KwikNet Library which

was built to include error reporting.

1 ... 40 41 42 ... 316

No comments

AMX DESIGN XPRESS V 1.5 - PROGRAMMER GUIDE User's Guide Page 41