Source code of Windows XP (NT5)
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.
 
 
 
 
 
 

175 lines
4.6 KiB

/* File: avUtil.h (was debug.h + runtime.h)
Used by NAC.dll and H323CC.dll, and QOS.LIB
*/
#ifndef _AVUTIL_H
#define _AVUTIL_H
#include <nmutil.h>
#include <pshpack8.h> /* Assume 8 byte packing throughout */
/***********************************************************************
*
* Registry access easy-wrapper functions prototypes
*
***********************************************************************/
UINT NMINTERNAL RegistryGetInt(HKEY hPDKey, LPCTSTR lpszSection, LPCTSTR lpszKey, INT dwDefault,
LPCTSTR lpszFile);
DWORD NMINTERNAL RegistryGetString(HKEY hPDKey, LPCTSTR lpszSection, LPCTSTR lpszKey,
LPCTSTR lpszDefault, LPTSTR lpszReturnBuffer, DWORD cchReturnBuffer,
LPCTSTR lpszFile);
BOOL NMINTERNAL RegistrySetString(HKEY hPDKey, LPCTSTR lpszSection, LPCTSTR lpszKey,
LPCTSTR lpszString, LPCTSTR lpszFile);
BOOL NMINTERNAL RegistrySetInt(HKEY hPDKey, LPCTSTR lpszSection, LPCTSTR lpszKey,
DWORD i, LPCTSTR lpszFile);
DWORD NMINTERNAL RegistryGetBinData(HKEY hPDKey, LPCTSTR lpszSection, LPCTSTR lpszKey,
LPVOID lpvDefault, DWORD cchDefault, LPVOID lpvReturnBuffer, DWORD cchReturnBuffer,
LPCTSTR lpszFile);
BOOL NMINTERNAL RegistrySetBinData(HKEY hPDKey, LPCTSTR lpszSection, LPCTSTR lpszKey,
LPVOID lpvBinData, DWORD cchBinData, LPCTSTR lpszFile);
/**********************************************************************
*
* Debug Macros
**********************************************************************/
/*
* Debug message types
*/
#define AVERROR 0
#define AVTRACE 1
#define AVTRACEMEM 2
#define AVTESTTRACE 3
//****** Retail
// MACRO: RETAILMSG(message-to-print)
// PURPOSE: Prints a message to the debug output
// NOTE: available in all builds, depends on the registry flag
#define RETAILMSG(x) RetailPrintfTrace x
VOID WINAPI RetailPrintfTrace(LPCSTR lpszFormat, ...);
//****** Test and Debug
// in test and debug build, doesnt depent on the registry flag
#if defined(TEST) || defined(DEBUG)
#define TESTMSG(x) TestPrintfTrace x
void __cdecl TestPrintfTrace(LPCSTR lpszFormat, ...);
#define ERRORMSG(x) ERROR_OUT(x)
#else
#define ERRORMSG(x)
#define TESTMSG(x)
#endif
//****** Debug only
#if defined(DEBUG)
// MACRO: DebugTrap(void)
// PURPOSE: Executes a debug break (like 'int 3' on x86)
#define DebugTrap DebugTrapFn()
#define DEBUGCHK(e) if(!(e)) DebugTrap
/*
* MACRO: DebugPrintError(LPCSTR)
*
* PURPOSE: Prints an error string to the debug output terminal
*
* PARAMETERS:
* lpszFormat - a printf-style format
*
* RETURN VALUE:
* none
*
* COMMENTS:
* This macro calls the generic debug print macro, specifying
* that this is an error message
*
*/
#define DebugPrintError(x) ERROR_OUT(x)
/*
* MACRO: DebugPrintErrorFileLine(DWORD, LPSTR)
*
* PURPOSE: Pretty print an error to the debugging output.
*
* PARAMETERS:
* dwError - Actual error code
* pszPrefix - String to prepend to the printed message.
*
* RETURN VALUE:
* none
*
* COMMENTS:
* It will take the error, turn it into a human
* readable string, prepend pszPrefix (so you
* can tag your errors), append __FILE__ and __LINE__
* and print it to the debugging output.
*
* This macro is just a wrapper around OutputDebugLineErrorFileLine
* that is necessary to get proper values for __FILE__ and __LINE__.
*
*/
#define DebugPrintErrorFileLine(dwError, pszPrefix) \
DebugPrintFileLine(dwError, pszPrefix,\
__FILE__, __LINE__)
/*
* MACRO: DebugPrintTraceFileLine(DWORD, LPSTR)
*
* PURPOSE: Pretty print a trace message to the debugging output.
*
* PARAMETERS:
* dwParam- A paramter to trace
* pszPrefix - String to prepend to the printed message.
*
* RETURN VALUE:
* none
*
* COMMENTS:
* Takes a parameter, prepend pszPrefix (so you
* can tag your traces), append __FILE__ and __LINE__
* and print it to the debugging output.
*
* This macro is just a wrapper around OutputDebugLineErrorFileLine
* that is necessary to get proper values for __FILE__ and __LINE__.
*
*/
#define DebugPrintTraceFileLine(dwParam, pszPrefix) \
DebugPrintFileLine(dwParam, pszPrefix,\
__FILE__, __LINE__)
void DebugPrintFileLine(
DWORD dwError, LPSTR szPrefix,
LPSTR szFileName, DWORD nLineNumber);
VOID NMINTERNAL DebugTrapFn(void);
#else // not DEBUG
#define DEBUGMSG(z,s)
#define DebugTrap
#define DebugPrintError(x)
#define DebugPrintTrace(x)
#define DebugPrintTraceFileLine(dwParam, pszPrefix)
#define DEBUGCHK(e)
#endif
#define GETMASK(hDbgZone) \
((hDbgZone) ? (((PZONEINFO)(hDbgZone))->ulZoneMask) : (0))
#include <poppack.h> /* End byte packing */
#endif //#ifndef _AVUTIL_H