windows-nt/Source/XPSP1/NT/windows/richedit/re41/_debug.h

431 lines
16 KiB
C
Raw Permalink Normal View History

2020-09-26 03:20:57 -05:00
/*
* _DEBUG.H
*
* Purpose:
* RICHEDIT debugging support--commented out in ship builds
*
* History: <nl>
* 7/29/98 KeithCu Wrote it stealing much from Rich Arneson's code
*
* Copyright (c) 1995-1998, Microsoft Corporation. All rights reserved.
*/
#ifndef _DEBUG_H
#define _DEBUG_H
#define DllExport __declspec(dllexport)
#if !defined(NOFULLDEBUG) && (defined(DEBUG) || defined(_RELEASE_ASSERTS_))
#define ASSERTDATA static char _szFile[] = __FILE__;
BOOL WINAPI DebugMain (HINSTANCE hDLL, DWORD dwReason, LPVOID lpReserved);
#else // DEBUG
#define ASSERTDATA
#define DebugMain(hDll, dwReason, lpReserved)
#endif // DEBUG, else
//This is the buffer length used for building messages
#define MAXDEBUGSTRLEN (MAX_PATH + MAX_PATH)
//The following constants are used to specify and interpret
//packed values in the DWORD flags parameter passed to TraceMsg.
//Each of these is held in a 4-bit field in the DWORD.
//Subsystem field values
#define TRCSUBSYSNONE 0x0
#define TRCSUBSYSDISP 0x1
#define TRCSUBSYSWRAP 0x2
#define TRCSUBSYSEDIT 0x3
#define TRCSUBSYSTS 0x4
#define TRCSUBSYSTOM 0x5
#define TRCSUBSYSOLE 0x6
#define TRCSUBSYSBACK 0x7
#define TRCSUBSYSSEL 0x8
#define TRCSUBSYSHOST 0x9
#define TRCSUBSYSDTE 0xa
#define TRCSUBSYSUNDO 0xb
#define TRCSUBSYSRANG 0xc
#define TRCSUBSYSUTIL 0xd
#define TRCSUBSYSNOTM 0xe
#define TRCSUBSYSRTFR 0xf
#define TRCSUBSYSRTFW 0x10
#define TRCSUBSYSPRT 0x11
#define TRCSUBSYSFE 0x12
#define TRCSUBSYSFONT 0x13
//Severity field values
#define TRCSEVNONE 0x0
#define TRCSEVWARN 0x1
#define TRCSEVERR 0x2
#define TRCSEVASSERT 0x3
#define TRCSEVINFO 0x4
#define TRCSEVMEM 0x5
//Scope field values
#define TRCSCOPENONE 0x0
#define TRCSCOPEEXTERN 0x1
#define TRCSCOPEINTERN 0x2
//Data field values
#define TRCDATANONE 0x0
#define TRCDATAHRESULT 0x1
#define TRCDATASTRING 0x2
#define TRCDATAPARAM 0x3
#define TRCDATADEFAULT 0x4
//Debug option flags. See the macros in this header for setting and testing
//these option flags.
#define OPTUSEDEFAULTS 0x00000001 //Use defaults from win.ini
//(used only with InitDebugServices).
#define OPTLOGGINGON 0x00000008 //Logging of trace output
#define OPTVERBOSEON 0x00000010 //Subsys, Scope & PID/TID
#define OPTINFOON 0x00000020 //Informational messages
#define OPTTRACEON 0x00000040 //All function tracing on
#define OPTTRACEEXT 0x00000080 //Function tracing only for external functions
#define OPTMEMORYON 0x00000100 //Memory alloc/free tracing on
//The following options allow tracing to be enabled for one or more
//specific subsystems. If OPTTRACEON is set, these will have no effect.
//if OPTTRACEEXT is set, they will enable tracing for all functions in
//the designated subsystem in addition to external functions.
//The SETOPT and ISOPTSET macros should be used for setting and checking
//these options. INITDEBUGSERVICES can also be used.
#define OPTTRACEDISP 0x00001000 //Function tracing for Display subsystem
#define OPTTRACEWRAP 0x00002000 //Function tracing for Wrapper subsystem
#define OPTTRACEEDIT 0x00004000 //Function tracing for Edit subsystem
#define OPTTRACETS 0x00008000 //Function tracing for TextServices subsystem
#define OPTTRACETOM 0x00010000 //Function tracing for TOM subsystem
#define OPTTRACEOLE 0x00020000 //Function tracing for OLE support subsystem
#define OPTTRACEBACK 0x00040000 //Function tracing for Backing Store subsystem
#define OPTTRACESEL 0x00080000 //Function tracing for Selection subsystem
#define OPTTRACEHOST 0x00100000 //Function tracing for WinHost subsystem
#define OPTTRACEDTE 0x00200000 //Function tracing for DataXfer subsystem
#define OPTTRACEUNDO 0x00400000 //Function tracing for Muli-undo subsystem
#define OPTTRACERANG 0x00800000 //Function tracing for Range subsystem
#define OPTTRACEUTIL 0x01000000 //Function tracing for Utility subsystem
#define OPTTRACENOTM 0x02000000 //Function tracing for Notification Mgr subsystem
#define OPTTRACERTFR 0x04000000 //Function tracing for RTF reader subsystem
#define OPTTRACERTFW 0x08000000 //Function tracing for RTF writer subsystem
#define OPTTRACEPRT 0x10000000 //Function tracing for Printing subsystem
#define OPTTRACEFE 0x20000000 //Function tracing for East Asia subsystem
#define OPTTRACEFONT 0x40000000 //Function tracing for Font Cache
#if !defined(NOFULLDEBUG) && (defined(DEBUG) || defined(_RELEASE_ASSERTS_))
#ifndef _RELEASE_ASSERTS_
//Union for handling tracing flags
//This union is used to decode the
//packed DWORD passed to TraceMsg.
typedef union
{
struct
{
unsigned uData2 :4;
unsigned uData1 :4;
unsigned uScope :4;
unsigned uSeverity :4;
unsigned uSubSystem :8;
unsigned uUnused1 :4;
unsigned uUnused2 :4;
} fields;
DWORD dw;
} TrcFlags;
//Exported classes and functions.
//Generally, these should not be used directly by the user.
//They should be used via the macros defined in this header.
//This helps to ensure that the parameter lists are well
//formed and keeps references to them from showing up in
//in non-debug builds.
//This class is used to implement the function Entry/Exit
//tracing. By declaring it on the stack at the beginning
//of a function, Entry and Exit messages are automatically
//generated by the constructor and destructor.
class CTrace
{
public:
CTrace(DWORD, DWORD, DWORD, LPSTR);
~CTrace();
private:
TrcFlags trcf;
char szFileName[MAXDEBUGSTRLEN];
char szFuncName[80];
};
extern DWORD dwDebugOptions;
extern void SetLogging(BOOL);
void Tracef(DWORD, LPSTR szFmt, ...);
void TraceError(LPSTR sz, LONG sc);
#endif //!_RELEASE_ASSERTS_
typedef BOOL (CALLBACK * PFNASSERTHOOK)(LPSTR, LPSTR, int*);
typedef BOOL (CALLBACK * PFNTRACEHOOK)(DWORD*, DWORD*, DWORD*, LPSTR, int*);
extern PFNTRACEHOOK pfnTrace;
extern PFNASSERTHOOK pfnAssert;
void AssertSzFn(LPSTR, LPSTR, int);
void TraceMsg(DWORD, DWORD, DWORD, LPSTR, int);
DllExport void WINAPI InitDebugServices(DWORD, PFNASSERTHOOK, PFNTRACEHOOK);
//Assert based on boolean f.
#define Assert(f) AssertSz((f), NULL)
//Assert based on boolean f in debug, resolve to f in non-debug.
#define SideAssert(f) AssertSz((f), NULL)
//Assert based on boolean f and use string sz in assert message.
#define AssertSz(f, sz) (!(f) ? AssertSzFn(sz, __FILE__, __LINE__) : 0)
//Set an assert or trace hook function. The function specified will be called
//before the default functionality executes. Pointers to all parameters are passed
//to the hook to allow it to modify them. If the hook function returns false,
//default functionality is terminated. If the hook function returns true, default
//functionality continues with the potentially modified parameters. pfn can
//be NULL (default functionality only).
#define SETASSERTFN(pfn) (pfnAssert = (pfn))
//The following macros provide access to the debug services in this dll.
//Assert macros pop a dialog. Trace macros output to debug output and
//logfile if enabled.
//Macro for InitDebugServices
#define INITDEBUGSERVICES(f, pfnA, pfnT) InitDebugServices(f, pfnA, pfnT)
//This is a utility macro for internal use. The user should not need this.
#define MAKEFLAGS(ss, sv, sc, d1, d2) ((ss << 16) + (sv << 12) + (sc << 8)\
+ (d1 << 4) + (d2))
#ifndef _RELEASE_ASSERTS_
//Assert only on debug builds, not on _RELEASE_ASSERTS_ builds
//This is for asserts that contain debug only code
#ifndef AssertNr
#define AssertNr(f) AssertSz((f), NULL)
#endif
#ifndef AssertNrSz
#define AssertNrSz(f, sz) (!(f) ? AssertSzFn(sz, __FILE__, __LINE__) : 0)
#endif
//Macro for TraceError
#define TRACEERRSZSC(sz, sc) TraceError(sz, sc)
//Warning based on GetLastError or default message if no last error.
#define TRACEWARN TraceMsg(MAKEFLAGS(TRCSUBSYSNONE, TRCSEVWARN,\
TRCSCOPENONE, TRCDATADEFAULT, TRCDATANONE),\
(DWORD)0, (DWORD)0, __FILE__, __LINE__)
//Error based on GetLastError or default message if no last error.
#define TRACEERROR TraceMsg(MAKEFLAGS(TRCSUBSYSNONE, TRCSEVERR,\
TRCSCOPENONE, TRCDATADEFAULT, TRCDATANONE),\
(DWORD)0, (DWORD)0, __FILE__, __LINE__)
//Warning based on HRESULT hr
#define TRACEWARNHR(hr) TraceMsg(MAKEFLAGS(TRCSUBSYSNONE, TRCSEVWARN,\
TRCSCOPENONE, TRCDATAHRESULT, TRCDATANONE),\
(DWORD)(hr), (DWORD)0, __FILE__, __LINE__)
//Test for a failure HR && warn
#define TESTANDTRACEHR(hr) if( hr < 0 ) { TRACEWARNHR(hr); }
//Error based on HRESULT hr
#define TRACEERRORHR(hr) TraceMsg(MAKEFLAGS(TRCSUBSYSNONE, TRCSEVERR,\
TRCSCOPENONE, TRCDATAHRESULT, TRCDATANONE),\
(DWORD)(hr), (DWORD)0, __FILE__, __LINE__)
//Warning using string sz
#define TRACEWARNSZ(sz) TraceMsg(MAKEFLAGS(TRCSUBSYSNONE, TRCSEVWARN,\
TRCSCOPENONE, TRCDATASTRING, TRCDATANONE),\
(DWORD)(DWORD_PTR)(sz), (DWORD)0, __FILE__, __LINE__)
//Trace based on Assert, user passes file name and line
#define TRACEASSERT(szFile, iLine) TraceMsg (MAKEFLAGS(TRCSUBSYSNONE,\
TRCSEVASSERT, TRCSCOPENONE,\
TRCDATANONE, TRCDATANONE),\
(DWORD)0, (DWORD)0, szFile, iLine)
//Trace based on Assert, user passes file name and line
#define TRACEASSERTSZ(sz, szFile, iLine) TraceMsg (MAKEFLAGS(TRCSUBSYSNONE,\
TRCSEVASSERT, TRCSCOPENONE,\
TRCDATASTRING, TRCDATANONE),\
(DWORD)(DWORD_PTR)sz, (DWORD)0, szFile, iLine)
//Error using string sz
#define TRACEERRORSZ(sz) TraceMsg(MAKEFLAGS(TRCSUBSYSNONE, TRCSEVERR,\
TRCSCOPENONE, TRCDATASTRING, TRCDATANONE),\
(DWORD)(DWORD_PTR)(sz), (DWORD)0, __FILE__, __LINE__)
//Error using string sz
#define TRACEINFOSZ(sz) TraceMsg(MAKEFLAGS(TRCSUBSYSNONE, TRCSEVINFO,\
TRCSCOPENONE, TRCDATASTRING, TRCDATANONE),\
(DWORD)(DWORD_PTR)(sz), (DWORD)0, __FILE__, __LINE__)
//Initiate tracing. This declares an instance of the CTtrace class
//on the stack. Subsystem (ss), Scope (sc), and the function name
//(sz) must be specifed. ss and sc are specified using the macros
//defined in this header (i.e. - TRCSUBSYSTOM, TRCSCOPEEXTERN, etc.).
//sz can be a static string.
#define TRACEBEGIN(ss, sc, sz) CTrace trc(MAKEFLAGS((ss), TRCSEVNONE,\
(sc), TRCDATASTRING, TRCDATANONE),\
(DWORD)(DWORD_PTR)(sz), (DWORD)0, __FILE__)
//Same as TRACEBEGIN but it takes the additional param which is interpreted
//by TraceMsg as a Text Message request.
#define TRACEBEGINPARAM(ss, sc, sz, param) \
CTrace trc(MAKEFLAGS((ss), TRCSEVNONE,\
(sc), TRCDATASTRING, TRCDATAPARAM),\
(DWORD)(DWORD_PTR)(sz), (DWORD)(param), __FILE__)
//Set logging to on (f = TRUE) or off (f = FALSE)
#define SETLOGGING(f) SetLogging(f)
//Set output of process & thread IDs to on (f = TRUE) or off (f = FALSE)
#define SETVERBOSE(f) ((f) ? (dwDebugOptions |= OPTVERBOSEON) :\
(dwDebugOptions &= ~OPTVERBOSEON))
//Set information messages to on (f = TRUE) or off (f = FALSE)
#define SETINFO(f) ((f) ? (dwDebugOptions |= OPTINFOON) :\
(dwDebugOptions &= ~OPTINFOON))
//Set information messages to on (f = TRUE) or off (f = FALSE)
#define SETMEMORY(f) ((f) ? (dwDebugOptions |= OPTMEMORYON) :\
(dwDebugOptions &= ~OPTMEMORYON))
//Set tracing for all functions to on (f = TRUE) or off (f = FALSE).
//If this is set to "on", external and subsystem level tracing
//has no effect since all function traces are enabled. If it is off,
//external and subsystem level tracing remain in whatever state they
//have been set to.
#define SETTRACING(f) ((f) ? (dwDebugOptions |= OPTTRACEON) :\
(dwDebugOptions &= ~OPTTRACEON))
//Set tracing for EXTERNAL scope calls only to on (f = TRUE)
//or off (f = FALSE). This is only effective if OPTTRACEON has not
//been set.
#define SETTRACEEXT(f) ((f) ? (dwDebugOptions |= OPTTRACEEXT) :\
(dwDebugOptions &= ~OPTTRACEEXT))
//This macro turns all function tracing off.
#define SETALLTRACEOFF (dwDebugOptions &= ~(OPTTRACEEXT | OPTTRACEON | 0xfffff000))
//This macro sets a given option or options (if they are or'ed together)
//to on (f = TRUE), or off (f = FALSE). It cannot be used to set logging.
#define SETOPT(opt, f) ((f) ? (dwDebugOptions |= (opt)) :\
(dwDebugOptions &= (~(opt))))
//This macro determines the state of a given option.
#define ISOPTSET(opt) ((opt) & dwDebugOptions)
//Set an assert or trace hook function. The function specified will be called
//before the default functionality executes. Pointers to all parameters are passed
//to the hook to allow it to modify them. If the hook function returns false,
//default functionality is terminated. If the hook function returns true, default
//functionality continues with the potentially modified parameters. pfn can
//be NULL (default functionality only).
#define SETTRACEFN(pfn) (pfnTrace = (pfn))
//The following option tests are explicitly defined for convenience.
#define fLogging (OPTLOGGINGON & dwDebugOptions)
#define fVerbose (OPTVERBOSEON & dwDebugOptions)
#define fInfo (OPTINFOON & dwDebugOptions)
#define fTrace (OPTTRACEON & dwDebugOptions)
#define fTraceExt (OPTTRACEEXT & dwDebugOptions)
#else //_RELEASE_ASSERTS_
//Functions not used by release build with asserts
#ifndef AssertNr
#define AssertNr(f)
#endif
#ifndef AssertNrSz
#define AssertNrSz(f, sz)
#endif
#define Tracef ;/##/
#define TRACEERRSZSC(sz, sc)
#define TRACEWARN
#define TRACEERROR
#define TRACEWARNHR(hr)
#define TESTANDTRACEHR(hr)
#define TRACEERRORHR(hr)
#define TRACEWARNSZ(sz)
#define TRACEASSERT(szFile, iLine)
#define TRACEASSERTSZ(sz, szFile, iLine)
#define TRACEERRORSZ(sz)
#define TRACEINFOSZ(sz)
#define TRACEBEGIN(ss, sc, sz)
#define TRACEBEGINPARAM(ss, sc, sz, param)
#define SETLOGGING(f)
#define SETVERBOSE(f)
#define SETINFO(f)
#define SETMEMORY(f)
#define SETTRACING(f)
#define SETTRACEEXT(f)
#define SETALLTRACEOFF
#define SETOPT(opt, f)
#define ISOPTSET(opt)
#define SETTRACEFN(pfn)
#define TraceError(_sz, _sc)
#endif //_RELEASE_ASSERTS_
#else // !(!defined(NOFULLDEBUG) && (defined(DEBUG) || defined(_RELEASE_ASSERTS_)))
#if defined(NOFULLDEBUG) && defined(DEBUG)
__inline void Tracef(DWORD, LPSTR, ...) {};
__inline void Assert(bool) {};
__inline void AssertSz(bool, char *) {};
typedef BOOL (CALLBACK * PFNASSERTHOOK)(LPSTR, LPSTR, int*);
extern PFNASSERTHOOK pfnAssert;
#else // !defined(NOFULLDEBUG)
#define Tracef ;/##/
#ifndef Assert
#define Assert(f)
#endif
#ifndef AssertSz
#define AssertSz(f, sz)
#endif
#endif
#define INITDEBUGSERVICES(f, pfnA, pfnT)
#define TRACEERRSZSC(sz, sc)
#ifndef SideAssert
#define SideAssert(f) (f)
#endif
#ifndef AssertNr
#define AssertNr(f)
#endif
#ifndef AssertNrSz
#define AssertNrSz(f, sz)
#endif
#define TRACEWARN
#define TRACEERROR
#define TRACEWARNHR(hr)
#define TESTANDTRACEHR(hr)
#define TRACEERRORHR(hr)
#define TRACEWARNSZ(sz)
#define TRACEASSERT(szFile, iLine)
#define TRACEASSERTSZ(sz, szFile, iLine)
#define TRACEERRORSZ(sz)
#define TRACEINFOSZ(sz)
#define TRACEBEGIN(ss, sc, sz)
#define TRACEBEGINPARAM(ss, sc, sz, param)
#define SETLOGGING(f)
#define SETVERBOSE(f)
#define SETINFO(f)
#define SETMEMORY(f)
#define SETTRACING(f)
#define SETTRACEEXT(f)
#define SETALLTRACEOFF
#define SETOPT(opt, f)
#define ISOPTSET(opt)
#define SETASSERTFN(pfn)
#define SETTRACEFN(pfn)
#define AssertSzFn(sz, __FILE__, __LINE__)
#define TraceError(_sz, _sc)
#endif
#endif //DEBUG_H