233 lines
6.3 KiB
C
233 lines
6.3 KiB
C
//____________________________________________________________________________
|
|
//
|
|
// Microsoft Windows
|
|
// Copyright (C) Microsoft Corporation, 1995 - 1996.
|
|
//
|
|
// File: StdDbg.h
|
|
//
|
|
// Contents: Common debug definitions.
|
|
//
|
|
// History: 5/20/1996 RaviR Created
|
|
//
|
|
//____________________________________________________________________________
|
|
|
|
|
|
#include "admindbg.h"
|
|
#include <tchar.h>
|
|
|
|
//
|
|
// EXAMPLE: A debug file for component SAMPLE, with the debugging tag
|
|
// name "Samp" is defined as shown below:
|
|
//
|
|
//
|
|
// //
|
|
// // File: SampDbg.h
|
|
// //
|
|
//
|
|
// #ifndef _SAMPDBG_H_
|
|
// #define _SAMPDBG_H_
|
|
//
|
|
// #include "stddbg.h"
|
|
//
|
|
// #if DBG==1
|
|
// DECLARE_DEBUG(Samp)
|
|
// #define DBG_COMP SampInfoLevel
|
|
// #endif // DBG==1
|
|
//
|
|
// #endif // _SAMPDBG_H_
|
|
//
|
|
|
|
|
|
//
|
|
// A corresponding DECLARE_INFOLEVEL(Samp) should be implemented in a .cpp
|
|
// file. This creates a global instance of an CDbg -> SampInfoLevel.
|
|
// SampInfoLevel can be initialized by setting the "Samp" value under reg key
|
|
//
|
|
// HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\AdminDebug
|
|
//
|
|
// By defalut it is set to (DEB_ERROR | DEB_WARN)
|
|
//
|
|
|
|
|
|
//
|
|
// ------------------------------------------------------------------------
|
|
// Method: CDbg::DebugOut(debug_level, lpstrfmt, ...);
|
|
//
|
|
// Where debug_level is a combination of one or more of the DEB_XXX
|
|
// values defined in admindbg.h. If ((SampInfoLevel & debug_level) != 0)
|
|
// The string lpstrfmt will be printed out to the debugger.
|
|
//
|
|
// ------------------------------------------------------------------------
|
|
// Method: CDbg::Trace(lpstrfmt, ...);
|
|
//
|
|
// Same as CDbg::DebugOut, except that debug_level is internally
|
|
// set to DEB_TRACE.
|
|
//
|
|
// ------------------------------------------------------------------------
|
|
// Method: DebugMsg(file, line, message)
|
|
//
|
|
// Force output the <file, line, message>.
|
|
//
|
|
// ------------------------------------------------------------------------
|
|
//
|
|
|
|
|
|
#ifndef __STDDBG_HXX__
|
|
#define __STDDBG_HXX__
|
|
|
|
#undef ASSERT
|
|
#undef ASSERTMSG
|
|
|
|
//
|
|
// C++ files redefine THIS_FILE by adding the following two lines:
|
|
//
|
|
// #undef THIS_FILE
|
|
// static char THIS_FILE[] = __FILE__;
|
|
//
|
|
|
|
#define THIS_FILE __FILE__
|
|
|
|
#undef TRACE
|
|
#undef ASSERT
|
|
#undef VERIFY
|
|
|
|
|
|
#if DBG==1
|
|
|
|
#define Dbg DBG_COMP.DebugOut
|
|
#define TRACE DBG_COMP.Trace
|
|
|
|
// Heap checking
|
|
extern DWORD dwHeapChecking;
|
|
#define DECLARE_HEAPCHECKING DWORD dwHeapChecking = 0
|
|
|
|
#define DEBUGCHECK \
|
|
if ( (dwHeapChecking & 0x1) == 0x1 ) \
|
|
{ \
|
|
HeapValidate(GetProcessHeap(),0,NULL); \
|
|
} else 1
|
|
|
|
#define DBG_INDENTER \
|
|
CIndenter Indent(&DBG_COMP)
|
|
|
|
// Debug messages
|
|
#define TRACE_CONSTRUCTOR(cls) \
|
|
DEBUGCHECK; \
|
|
Dbg(DEB_RESOURCE, _T(#cls) _T("::") _T(#cls) _T("<%x>\n"), this); \
|
|
DBG_INDENTER;
|
|
|
|
#define TRACE_DESTRUCTOR(cls) \
|
|
DEBUGCHECK; \
|
|
Dbg(DEB_RESOURCE, _T(#cls) _T("::~") _T(#cls) _T("<%x>\n"), this); \
|
|
DBG_INDENTER;
|
|
|
|
#define TRACE_METHOD(Class, Method) \
|
|
DEBUGCHECK; \
|
|
Dbg(DEB_METHOD, _T(#Class) _T("::") _T(#Method) _T("(%x)\n"), this); \
|
|
DBG_INDENTER;
|
|
|
|
#define TRACE_FUNCTION(Function) \
|
|
DEBUGCHECK; \
|
|
Dbg(DEB_FUNCTION, _T(#Function) _T("\n")); \
|
|
DBG_INDENTER;
|
|
|
|
#define TRACE_CONSTRUCTOR_EX(Infolevel, cls) \
|
|
DEBUGCHECK; \
|
|
Dbg(Infolevel, _T(#cls) _T("::") _T(#cls) _T("<%x>\n"), this); \
|
|
DBG_INDENTER;
|
|
|
|
#define TRACE_DESTRUCTOR_EX(Infolevel, cls) \
|
|
DEBUGCHECK; \
|
|
Dbg(Infolevel, _T(#cls) _T("::~") _T(#cls) _T("<%x>\n"), this); \
|
|
DBG_INDENTER;
|
|
|
|
#define TRACE_METHOD_EX(Infolevel, Class, Method) \
|
|
DEBUGCHECK; \
|
|
Dbg(Infolevel, _T(#Class) _T("::") _T(#Method) _T("(%x)\n"), this); \
|
|
DBG_INDENTER;
|
|
|
|
#define TRACE_FUNCTION_EX(Infolevel, Function) \
|
|
DEBUGCHECK; \
|
|
Dbg(Infolevel, _T(#Function) _T("\n")); \
|
|
DBG_INDENTER;
|
|
|
|
#define CHECK_HRESULT(hr) \
|
|
if ( FAILED(hr) ) \
|
|
{ \
|
|
DBG_COMP.DebugErrorX(THIS_FILE, __LINE__, hr); \
|
|
} else 1
|
|
|
|
#define CHECK_LASTERROR(lr) \
|
|
if ( lr != ERROR_SUCCESS ) \
|
|
{ \
|
|
DBG_COMP.DebugErrorL(THIS_FILE, __LINE__, lr); \
|
|
} else 1
|
|
|
|
#define DBG_OUT_LASTERROR \
|
|
DBG_COMP.DebugErrorL(THIS_FILE, __LINE__, GetLastError());
|
|
|
|
#define ASSERTMSG(x) \
|
|
(void)((x) || (DBG_COMP.DebugMsg(THIS_FILE, __LINE__, _T(#x)),0))
|
|
|
|
#define VERIFYMSG(e) ASSERTMSG(e)
|
|
|
|
#define ASSERT(x) Win4Assert(x)
|
|
#define VERIFY(x) Win4Assert(x)
|
|
|
|
#else
|
|
|
|
inline void __cdecl __DummyDbg(ULONG, PCWSTR, ...) { }
|
|
inline void __cdecl __DummyDbg(ULONG, LPCSTR, ...) { }
|
|
#define Dbg 1 ? (void)0 : ::__DummyDbg
|
|
|
|
inline void __cdecl __DummyTrace(PCWSTR, ...) { }
|
|
inline void __cdecl __DummyTrace(LPCSTR, ...) { }
|
|
#define TRACE 1 ? (void)0 : ::__DummyTrace
|
|
|
|
#define TRACE_SCOPE(x)
|
|
|
|
#define DECLARE_HEAPCHECKING
|
|
#define DEBUGCHECK
|
|
#define DBG_INDENTER
|
|
|
|
#define TRACE_CONSTRUCTOR(cls)
|
|
#define TRACE_DESTRUCTOR(cls)
|
|
#define TRACE_METHOD(ClassName,MethodName)
|
|
#define TRACE_FUNCTION(FunctionName)
|
|
#define TRACE_CONSTRUCTOR_EX(Infolevel, cls)
|
|
#define TRACE_DESTRUCTOR_EX(Infolevel, cls)
|
|
#define TRACE_METHOD_EX(Infolevel, ClassName, MethodName)
|
|
#define TRACE_FUNCTION_EX(Infolevel, FunctionName)
|
|
|
|
#define CHECK_HRESULT(hr)
|
|
#define CHECK_LASTERROR(lr)
|
|
|
|
#define DBG_OUT_LASTERROR
|
|
|
|
#define ASSERTMSG(e)
|
|
#define VERIFYMSG(e) e
|
|
|
|
#define ASSERT(e)
|
|
#define VERIFY(e) e
|
|
|
|
#endif // DBG==1
|
|
|
|
|
|
|
|
#ifdef UNICODE
|
|
#define DBGSTRING %ls
|
|
#else
|
|
#define DBGSTRING %s
|
|
#endif
|
|
|
|
|
|
#define SAFEDBGBSTR(x) ((x==NULL)?L"<NULL>":x)
|
|
#define SAFEDBGTCHAR(x) ((x==NULL)?_T("<NULL>"):x)
|
|
|
|
|
|
#define ASSERT_OBJECTPTR(x) ASSERT( NULL == (x) || !::IsBadWritePtr(x,sizeof(x)) );
|
|
#define ASSERT_STRINGPTR(x) ASSERT( NULL == (x) || AfxIsValidStringPtr(x) );
|
|
#define FREE_OBJECTPTR(x) { ASSERT_OBJECTPTR(x); delete x; x = NULL; }
|
|
|
|
#endif // __STDDBG_HXX__
|