1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
|
//+---------------------------------------------------------------------------
// Copyright (C) 1991, Microsoft Corporation.
//
// File: DEBNOT.h
//
// Contents: Private project-wide Win 4 definitions
//
// History: 23-Jul-91 KyleP Created.
// 15-Oct-91 KevinRo Major changes and comments added
// 18-Oct-91 vich Consolidated win4p.hxx
// 22-Oct-91 SatoNa Added SHLSTRICT
// 29-Apr-92 BartoszM Moved from win4p.h
// 3-Jun-92 BruceFo Added SMUISTRICT
// 17-Dec-92 AlexT Moved UN..._PARM out of DEVL==1
// 30-Sep-93 KyleP DEVL obsolete
// 18-Jun-94 AlexT Make Assert a better statement
//
//----------------------------------------------------------------------------
#ifndef __DEBNOT_H__
#define __DEBNOT_H__
#include <stdarg.h>
//----------------------------------------------------------------------------
// Parameter Macros
//
// To avoid compiler warnings for unimplemented functions, use
// UNIMPLEMENTED_PARM(x) for each unreferenced parameter. This will
// later be defined to nul to reveal functions that we forgot to implement.
//
// For functions which will never use a parameter, use
// UNREFERENCED_PARM(x).
//
#define UNIMPLEMENTED_PARM(x) (x)
#define UNREFERENCED_PARM(x) (x)
//----------------------------------------------------------------------------
//
// New STRICT defines should be added in two places below:
//
// 1) Add the following within the ifdef ALLSTRICT/endif:
//
// #ifndef xxSTRICT
// # define xxSTRICT
// #endif
//
// These entries are in alphabetical order.
//
// 2) Add the following to the #if clause that defines ANYSTRICT:
//
// #if ... || defined(xxSTRICT) || ...
//
// so that ANYSTRICT is defined if any of the STRICT defines are.
//
#if defined(WIN32)
#include <windef.h>
#endif
#ifndef EXPORTDEF
#define EXPORTDEF
#endif
#ifndef EXPORTIMP
#define EXPORTIMP
#endif
#ifndef EXPORTED
#define EXPORTED _cdecl
#endif
#ifndef APINOT
#ifdef _X86_
#define APINOT _stdcall
#else
#define APINOT _cdecl
#endif
#endif
//
// DEBUG -- DEBUG -- DEBUG -- DEBUG -- DEBUG
//
#if (DBG == 1) || (OFSDBG == 1)
//
// Debug print functions.
//
#ifdef __cplusplus
extern "C" {
# define EXTRNC "C"
#else
# define EXTRNC
#endif
// vdprintf should only be called from xxDebugOut()
EXPORTDEF void APINOT
vdprintf(
unsigned long ulCompMask,
char const *pszComp,
char const *ppszfmt,
va_list ArgList);
#define _Win4Assert Win4AssertEx
EXPORTDEF void APINOT
Win4AssertEx(
char const *pszFile,
int iLine,
char const *pszMsg);
EXPORTDEF int APINOT
PopUpError(
char const *pszMsg,
int iLine,
char const *pszFile);
#define _SetWin4InfoLevel SetWin4InfoLevel
EXPORTDEF unsigned long APINOT
SetWin4InfoLevel(
unsigned long ulNewLevel);
EXPORTDEF unsigned long APINOT
SetWin4InfoMask(
unsigned long ulNewMask);
#define _SetWin4AssertLevel SetWin4AssertLevel
EXPORTDEF unsigned long APINOT
SetWin4AssertLevel(
unsigned long ulNewLevel);
EXPORTDEF unsigned long APINOT
SetWin4ExceptionLevel(
unsigned long ulNewLevel);
#ifdef __cplusplus
}
#endif // __cplusplus
# define EXSTRICT // (EXception STRICT) - Enabled if ANYSTRICT is enabled
# define Win4Assert(x) \
(void)((x) || (Win4AssertEx(__FILE__, __LINE__, #x),0))
# define Assert(x) \
(void)((x) || (Win4AssertEx(__FILE__, __LINE__, #x),0))
# define Verify(x) Assert(x)
//
// Debug print macros
//
# define DEB_ERROR 0x00000001 // exported error paths
# define DEB_WARN 0x00000002 // exported warnings
# define DEB_TRACE 0x00000004 // exported trace messages
# define DEB_DBGOUT 0x00000010 // Output to debugger
# define DEB_STDOUT 0x00000020 // Output to stdout
# define DEB_IERROR 0x00000100 // internal error paths
# define DEB_IWARN 0x00000200 // internal warnings
# define DEB_ITRACE 0x00000400 // internal trace messages
# define DEB_USER1 0x00010000 // User defined
# define DEB_USER2 0x00020000 // User defined
# define DEB_USER3 0x00040000 // User defined
# define DEB_USER4 0x00080000 // User defined
# define DEB_USER5 0x00100000 // User defined
# define DEB_USER6 0x00200000 // User defined
# define DEB_USER7 0x00400000 // User defined
# define DEB_USER8 0x00800000 // User defined
# define DEB_USER9 0x01000000 // User defined
# define DEB_USER10 0x02000000 // User defined
# define DEB_USER11 0x04000000 // User defined
# define DEB_USER12 0x08000000 // User defined
# define DEB_USER13 0x10000000 // User defined
# define DEB_USER14 0x20000000 // User defined
# define DEB_USER15 0x40000000 // User defined
# define DEB_NOCOMPNAME 0x80000000 // suppress component name
# define DEB_FORCE 0x7fffffff // force message
# define ASSRT_MESSAGE 0x00000001 // Output a message
# define ASSRT_BREAK 0x00000002 // Int 3 on assertion
# define ASSRT_POPUP 0x00000004 // And popup message
# define EXCEPT_MESSAGE 0x00000001 // Output a message
# define EXCEPT_BREAK 0x00000002 // Int 3 on exception
# define EXCEPT_POPUP 0x00000004 // Popup message
# define EXCEPT_FAULT 0x00000008 // generate int 3 on access violation
# define EXCEPT_VERBOSE 0x00000010 // Output message even for "quiet" exceptions
//+----------------------------------------------------------------------
//
// DECLARE_DEBUG(comp)
// DECLARE_INFOLEVEL(comp)
//
// This macro defines xxDebugOut where xx is the component prefix
// to be defined. This declares a static variable 'xxInfoLevel', which
// can be used to control the type of xxDebugOut messages printed to
// the terminal. For example, xxInfoLevel may be set at the debug terminal.
// This will enable the user to turn debugging messages on or off, based
// on the type desired. The predefined types are defined below. Component
// specific values should use the upper 24 bits
//
// To Use:
//
// 1) In your components main include file, include the line
// DECLARE_DEBUG(comp)
// where comp is your component prefix
//
// 2) In one of your components source files, include the line
// DECLARE_INFOLEVEL(comp)
// where comp is your component prefix. This will define the
// global variable that will control output.
//
// It is suggested that any component define bits be combined with
// existing bits. For example, if you had a specific error path that you
// wanted, you might define DEB_<comp>_ERRORxxx as being
//
// (0x100 | DEB_ERROR)
//
// This way, we can turn on DEB_ERROR and get the error, or just 0x100
// and get only your error.
//
// Define values that are specific to your xxInfoLevel variable in your
// own file, like ciquery.hxx.
//
//-----------------------------------------------------------------------
# ifndef DEF_INFOLEVEL
# define DEF_INFOLEVEL (DEB_ERROR | DEB_WARN)
# endif
//
// Back to the info level stuff.
//
//
// For C++. and in a module which has access to GetProfileInt, automatically
// initialise the info level from a setting in the [Cairo Infolevels] section
// of win.ini
//
# if defined(__cplusplus) && defined(_CAIRO_) && !defined(KERNEL) && defined(GetProfileInt)
# define DECLARE_INFOLEVEL(comp) \
extern EXTRNC unsigned long comp##InfoLevel = GetProfileIntA ( \
"Cairo Infolevels", \
#comp, \
DEF_INFOLEVEL ); \
extern EXTRNC char *comp##InfoLevelString = #comp;
# else
// Simple initialisation
# define DECLARE_INFOLEVEL(comp) \
extern EXTRNC unsigned long comp##InfoLevel = DEF_INFOLEVEL; \
extern EXTRNC char *comp##InfoLevelString = #comp;
# endif
# ifdef __cplusplus
# define DECLARE_DEBUG(comp) \
extern EXTRNC unsigned long comp##InfoLevel; \
extern EXTRNC char *comp##InfoLevelString; \
_inline void \
comp##InlineDebugOut(unsigned long fDebugMask, char const *pszfmt, ...) \
{ \
if (comp##InfoLevel & fDebugMask) \
{ \
va_list va; \
va_start (va, pszfmt); \
vdprintf(fDebugMask, comp##InfoLevelString, pszfmt, va);\
va_end(va); \
} \
} \
\
class comp##CDbgTrace\
{\
private:\
unsigned long _ulFlags;\
char const * const _pszName;\
public:\
comp##CDbgTrace(unsigned long ulFlags, char const * const pszName);\
~comp##CDbgTrace();\
};\
\
inline comp##CDbgTrace::comp##CDbgTrace(\
unsigned long ulFlags,\
char const * const pszName)\
: _ulFlags(ulFlags), _pszName(pszName)\
{\
comp##InlineDebugOut(_ulFlags, "Entering %s\n", _pszName);\
}\
\
inline comp##CDbgTrace::~comp##CDbgTrace()\
{\
comp##InlineDebugOut(_ulFlags, "Exiting %s\n", _pszName);\
}
# else // ! __cplusplus
# define DECLARE_DEBUG(comp) \
extern EXTRNC unsigned long comp##InfoLevel; \
extern EXTRNC char *comp##InfoLevelString; \
_inline void \
comp##InlineDebugOut(unsigned long fDebugMask, char const *pszfmt, ...) \
{ \
if (comp##InfoLevel & fDebugMask) \
{ \
va_list va; \
va_start (va, pszfmt); \
vdprintf(fDebugMask, comp##InfoLevelString, pszfmt, va);\
va_end(va); \
} \
}
# endif // ! __cplusplus
#else // DBG == 0
//
// NO DEBUG -- NO DEBUG -- NO DEBUG -- NO DEBUG -- NO DEBUG
//
# define Win4Assert(x) NULL
# define Assert(x) NULL
# define Verify(x) (x)
# define DECLARE_DEBUG(comp)
# define DECLARE_INFOLEVEL(comp)
#endif // DBG == 0
#endif // __DEBNOT_H__
|
