You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
326 lines
9.7 KiB
326 lines
9.7 KiB
/****************************************************************************
|
|
|
|
Copyright (c) Microsoft Corporation 1997
|
|
All rights reserved
|
|
|
|
File: DEBUG.H
|
|
|
|
Debugging utilities header
|
|
|
|
***************************************************************************/
|
|
|
|
|
|
#ifndef _DEBUG_H_
|
|
#define _DEBUG_H_
|
|
|
|
// Trace Flags
|
|
#define TF_ALWAYS 0xFFFFFFFF
|
|
#define TF_NEVER 0x00000000
|
|
#define TF_QUERYINTERFACE 0x00000001 // Query Interface details
|
|
#define TF_FUNC 0x00000002 // Functions entrances w/parameters
|
|
#define TF_CALLS 0x00000004 // Function calls
|
|
#define TF_MEMORYALLOCS 0x00000008 // Memory Allocations
|
|
#define TF_DLL 0x00000010 // DLL specific
|
|
#define TF_WM 0x00000020 // Window Messages
|
|
#define TF_SCP 0x00000030 // SCP objects
|
|
|
|
#ifdef DEBUG
|
|
|
|
#pragma message("BUILD: DEBUG macros being built")
|
|
|
|
// Globals
|
|
extern DWORD g_TraceMemoryIndex;
|
|
extern DWORD g_dwCounter;
|
|
extern DWORD g_dwTraceFlags;
|
|
|
|
extern const TCHAR g_szTrue[];
|
|
extern const TCHAR g_szFalse[];
|
|
|
|
|
|
// Macros
|
|
#define DEFINE_MODULE( _module ) static const TCHAR g_szModule[] = TEXT(_module);
|
|
#define __MODULE__ g_szModule
|
|
#define DEFINE_THISCLASS( _class ) static const TCHAR g_szClass[] = TEXT(_class);
|
|
#define __THISCLASS__ g_szClass
|
|
#define DEFINE_SUPER( _super ) static const TCHAR g_szSuper[] = TEXT(_super);
|
|
#define __SUPER__ g_szSuper
|
|
|
|
#if defined(_X86_)
|
|
#define DEBUG_BREAK do { _try { _asm int 3 } _except (EXCEPTION_EXECUTE_HANDLER) {;} } while (0)
|
|
#else
|
|
#define DEBUG_BREAK DebugBreak( );
|
|
#endif
|
|
|
|
#define INITIALIZE_TRACE_MEMORY_PROCESS \
|
|
g_TraceMemoryIndex = TlsAlloc( ); \
|
|
TlsSetValue( g_TraceMemoryIndex, NULL); \
|
|
TraceMessage( TEXT(__FILE__), __LINE__, g_szModule, TF_DLL, TEXT("Thread Memory tracing initialize.\n") )
|
|
|
|
#define INITIALIZE_TRACE_MEMORY_THREAD \
|
|
TlsSetValue( g_TraceMemoryIndex, NULL); \
|
|
TraceMessage( TEXT(__FILE__), __LINE__, g_szModule, TF_DLL, TEXT("Thread Memory tracing initialize.\n") )
|
|
|
|
#define UNINITIALIZE_TRACE_MEMORY \
|
|
DebugMemoryCheck( ); \
|
|
TraceMessage( TEXT(__FILE__), __LINE__, g_szModule, TF_DLL, TEXT("Memory tracing terminated.\n") )
|
|
|
|
#ifdef Assert
|
|
#undef Assert
|
|
#endif
|
|
#define Assert( _fn ) \
|
|
if ( !(_fn) && AssertMessage( TEXT(__FILE__), __LINE__, g_szModule, TEXT(#_fn), !!(_fn) ) ) DEBUG_BREAK
|
|
|
|
#ifdef AssertMsg
|
|
#undef AssertMsg
|
|
#endif
|
|
#define AssertMsg( _fn, _msg ) \
|
|
if ( !(_fn) && AssertMessage( TEXT(__FILE__), __LINE__, g_szModule, TEXT(_msg), !!(_fn) ) ) DEBUG_BREAK
|
|
|
|
#define TraceAlloc( _flags, _size ) DebugAlloc( TEXT(__FILE__), __LINE__, g_szModule, _flags, _size, TEXT(#_size) )
|
|
#define TraceAllocString( _flags, _size ) DebugAlloc( TEXT(__FILE__), __LINE__, g_szModule, _flags, (_size) * sizeof(TCHAR), TEXT(#_size) )
|
|
#define TraceFree( _hmem ) DebugFree( _hmem )
|
|
|
|
//
|
|
// Tracing Macros
|
|
//
|
|
// All functions that begin with "Trace" are in both DEBUG and RETAIL, but
|
|
// in RETAIL they do not spew output.
|
|
//
|
|
|
|
// Displays file, line number, module and "_msg" only if the TF_FUNC is set
|
|
// in g_dwTraceFlags.
|
|
#define TraceFunc( _msg ) \
|
|
InterlockIncrement(g_dwCounter); \
|
|
TraceMessage( TEXT(__FILE__), __LINE__, g_szModule, TF_FUNC, TEXT("+ ") TEXT(_msg) );
|
|
|
|
// Displays file, line number, module, class name and "_msg" only if the
|
|
// TF_FUNC is set in g_dwTraceFlags.
|
|
#define TraceClsFunc( _msg ) \
|
|
InterlockIncrement(g_dwCounter); \
|
|
TraceMessage( TEXT(__FILE__), __LINE__, g_szModule, TF_FUNC, TEXT("+ %s::%s"), g_szClass, TEXT(_msg) );
|
|
|
|
// Return macro for TraceFunc() and TraceClsFunc()
|
|
#define TraceFuncExit() { \
|
|
TraceMessage( TEXT(__FILE__), __LINE__, g_szModule, TF_FUNC, TEXT("V*\n") ); \
|
|
InterlockDecrement(g_dwCounter); \
|
|
return; \
|
|
}
|
|
#define RETURN( _rval ) { \
|
|
TraceMessage( TEXT(__FILE__), __LINE__, g_szModule, TF_FUNC, TEXT("V\n") ); \
|
|
InterlockDecrement(g_dwCounter); \
|
|
return _rval; \
|
|
}
|
|
|
|
// If the value is not S_OK, it will display it.
|
|
#define HRETURN( _hr ) { \
|
|
if ( _hr ) \
|
|
TraceMessage( TEXT(__FILE__), __LINE__, g_szModule, TF_FUNC, TEXT("V hr = 0x%08x\n"), _hr ); \
|
|
else \
|
|
TraceMessage( TEXT(__FILE__), __LINE__, g_szModule, TF_FUNC, TEXT("V\n") ); \
|
|
InterlockDecrement(g_dwCounter); \
|
|
return _hr; \
|
|
}
|
|
|
|
// Displays the file, line number, module and function call and return from the
|
|
// function call (no return value displayed) for "_fn" only if the TF_CALLS is
|
|
// set in g_dwTraceFlags.
|
|
#define TraceDo( _fn ) {\
|
|
InterlockIncrement(g_dwCounter); \
|
|
TraceMessage( TEXT(__FILE__), __LINE__, g_szModule, TF_CALLS, TEXT("+ %s\n"), TEXT(#_fn) ); \
|
|
_fn; \
|
|
TraceMessage( TEXT(__FILE__), __LINE__, g_szModule, TF_CALLS, TEXT("V\n") ); \
|
|
InterlockDecrement(g_dwCounter); \
|
|
}
|
|
|
|
// This functions only asserts if the result is ZERO.
|
|
#define TraceAssertIfZero( _fn ) \
|
|
if ( !(_fn) && AssertMessage( TEXT(__FILE__), __LINE__, g_szModule, TEXT(#_fn), !!(_fn) ) ) DEBUG_BREAK
|
|
|
|
|
|
#define ErrorMsg( _fmt, _arg ) \
|
|
TraceMessage( TEXT(__FILE__), __LINE__, g_szModule, TF_ALWAYS, TEXT(_fmt), _arg );
|
|
|
|
|
|
//
|
|
// HRESULT testing macros
|
|
//
|
|
// These functions check HRESULT return values and display UI if conditions
|
|
// warrant only in DEBUG.
|
|
//
|
|
|
|
// Warning is display if HRESULT is anything but S_OK (0).
|
|
#define THR( _fn ) \
|
|
TraceHR( TEXT(__FILE__), __LINE__, g_szModule, TEXT(#_fn), _fn )
|
|
|
|
// Warning is display if HRESULT is anything but S_OK (0).
|
|
#define RRETURN( _fn ) { \
|
|
RETURN( TraceHR( TEXT(__FILE__), __LINE__, g_szModule, TEXT(#_fn), _fn ) ); \
|
|
}
|
|
|
|
|
|
//
|
|
// Other
|
|
//
|
|
#define BOOLTOSTRING( _fBool ) ( !!(_fBool) ? g_szTrue : g_szFalse )
|
|
|
|
//
|
|
// Trace/Debug Functions - these do not exist in RETAIL.
|
|
//
|
|
void
|
|
TraceMsg(
|
|
DWORD dwCheckFlags,
|
|
LPCSTR pszFormat,
|
|
... );
|
|
|
|
void
|
|
TraceMsg(
|
|
DWORD dwCheckFlags,
|
|
LPCWSTR pszFormat,
|
|
... );
|
|
|
|
void
|
|
DebugMsg(
|
|
LPCSTR pszFormat,
|
|
... );
|
|
|
|
void
|
|
DebugMsg(
|
|
LPCWSTR pszFormat,
|
|
... );
|
|
|
|
void
|
|
TraceMessage(
|
|
LPCTSTR pszFile,
|
|
const int uLine,
|
|
LPCTSTR pszModule,
|
|
DWORD dwCheckFlags,
|
|
LPCTSTR pszFormat,
|
|
... );
|
|
|
|
void
|
|
TraceMessageDo(
|
|
LPCTSTR pszFile,
|
|
const int uLine,
|
|
LPCTSTR pszModule,
|
|
DWORD dwCheckFlags,
|
|
LPCTSTR pszFormat,
|
|
LPCTSTR pszFunc,
|
|
... );
|
|
|
|
|
|
BOOL
|
|
AssertMessage(
|
|
LPCTSTR pszFile,
|
|
const int uLine,
|
|
LPCTSTR pszModule,
|
|
LPCTSTR pszfn,
|
|
BOOL fTrue );
|
|
|
|
HRESULT
|
|
TraceHR(
|
|
LPCTSTR pszFile,
|
|
const int uLine,
|
|
LPCTSTR pszModule,
|
|
LPCTSTR pszfn,
|
|
HRESULT hr );
|
|
|
|
//
|
|
// Memory tracing functions - these are remapped to the "Global" memory
|
|
// functions when in RETAIL.
|
|
//
|
|
HGLOBAL
|
|
DebugAlloc(
|
|
LPCTSTR pszFile,
|
|
const int uLine,
|
|
LPCTSTR pszModule,
|
|
UINT uFlags,
|
|
DWORD dwBytes,
|
|
LPCTSTR pszComment );
|
|
|
|
HGLOBAL
|
|
DebugFree(
|
|
HGLOBAL hMem );
|
|
|
|
// The memory functions don't exist in RETAIL.
|
|
HGLOBAL
|
|
DebugMemoryAdd(
|
|
HGLOBAL hglobal,
|
|
LPCTSTR pszFile,
|
|
const int uLine,
|
|
LPCTSTR pszModule,
|
|
UINT uFlags,
|
|
DWORD dwBytes,
|
|
LPCTSTR pszComment );
|
|
|
|
#define DebugMemoryAddHandle( _handle ) \
|
|
DebugMemoryAdd( _handle, TEXT(__FILE__), __LINE__, __MODULE__, GMEM_MOVEABLE, 0, TEXT(#_handle) );
|
|
|
|
#define DebugMemoryAddAddress( _pv ) \
|
|
DebugMemoryAdd( _pv, TEXT(__FILE__), __LINE__, __MODULE__, GMEM_FIXED, 0, TEXT(#_pv) );
|
|
|
|
#define TraceStrDup( _sz ) \
|
|
DebugMemoryAdd( StrDup( _sz ), TEXT(__FILE__), __LINE__, __MODULE__, GMEM_FIXED, 0, TEXT("StrDup(") TEXT(#_sz) TEXT(")") );
|
|
|
|
void
|
|
DebugMemoryDelete(
|
|
HGLOBAL hglobal );
|
|
|
|
void
|
|
DebugMemoryCheck( );
|
|
|
|
#ifdef __cplusplus
|
|
extern void* __cdecl operator new( size_t nSize, LPCTSTR pszFile, const int iLine, LPCTSTR pszModule );
|
|
#define new new( TEXT(__FILE__), __LINE__, __MODULE__ )
|
|
|
|
#endif
|
|
|
|
//
|
|
//
|
|
#else // it's RETAIL ******************************************************
|
|
//
|
|
//
|
|
|
|
// Debugging -> NOPs
|
|
#define Assert( _fn )
|
|
#define DEFINE_MODULE( _module )
|
|
#define DEFINE_THISCLASS( _class )
|
|
#define DEFINE_SUPER( _super )
|
|
#define BOOLTOSTRING( _fBool ) NULL
|
|
#define AssertMsg 1 ? (void)0 : (void)
|
|
#define TraceMsg 1 ? (void)0 : (void)
|
|
#define DebugMsg 1 ? (void)0 : (void)
|
|
#define ErrorMsg 1 ? (void)0 : (void)
|
|
#define TraceMessage 1 ? (void)0 : (void)
|
|
#define AssertMessage 1 ? (void)0 : (void)
|
|
#define TraceHR 1 ? (void)0 : (void)
|
|
#define TraceFunc 1 ? (void)0 : (void)
|
|
#define TraceClsFunc 1 ? (void)0 : (void)
|
|
#define TraceFuncExit()
|
|
#define DebugMemoryAddHandle( _handle )
|
|
#define DebugMemoryAddAddress( _pv )
|
|
#define INITIALIZE_TRACE_MEMORY_PROCESS
|
|
#define INITIALIZE_TRACE_MEMORY_THREAD
|
|
#define UNINITIALIZE_TRACE_MEMORY
|
|
#define DebugMemoryDelete( _h )
|
|
|
|
// Tracing -> just do operation
|
|
#define TraceDo( _fn ) _fn
|
|
#define TraceMsgDo( _fn, _msg ) _fn
|
|
#define TraceAssertIfZero( _fn ) _fn
|
|
|
|
// RETURN testing -> do retail
|
|
#define THR
|
|
#define RETURN( _fn ) return _fn
|
|
#define RRETURN( _fn ) return _fn
|
|
#define HRETURN( _hr ) return _hr
|
|
#define QIRETURN( _qi, _riid ) return _qi
|
|
|
|
// Memory Functions -> do retail
|
|
#define TraceAlloc( _flags, _size ) GlobalAlloc( _flags, _size )
|
|
#define TraceAllocString( _flags, _size ) GlobalAlloc( _flags, (_size) * sizeof(TCHAR) )
|
|
#define TraceFree( _pv ) GlobalFree( _pv )
|
|
#define TraceStrDup( _sz ) StrDup( _sz )
|
|
|
|
#endif // DBG==1
|
|
|
|
#endif // _DEBUG_H_
|