250 lines
12 KiB
C
250 lines
12 KiB
C
//+----------------------------------------------------------------------------
|
|
//
|
|
// Microsoft Windows
|
|
// Copyright (C) Microsoft Corporation, 1997-1998
|
|
//
|
|
// File: mshtmdbg.h
|
|
//
|
|
// Contents: External include file for mshtmdbg.dll
|
|
//
|
|
// ----------------------------------------------------------------------------
|
|
|
|
#ifndef _MSHTMDBG_H_
|
|
#define _MSHTMDBG_H_
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#define MSHTMDBG_API_VERSION (7) // Increment whenever API changes
|
|
|
|
struct IUnknown;
|
|
|
|
typedef INT TRACETAG;
|
|
typedef INT_PTR PERFTAG;
|
|
typedef INT_PTR PERFMETERTAG;
|
|
|
|
DWORD WINAPI DbgExGetVersion();
|
|
BOOL WINAPI DbgExIsFullDebug();
|
|
void WINAPI DbgExSetDllMain(HANDLE hDllHandle, BOOL (WINAPI *)(HANDLE, DWORD, LPVOID));
|
|
|
|
void WINAPI DbgExDoTracePointsDialog(BOOL fWait);
|
|
void WINAPI DbgExRestoreDefaultDebugState();
|
|
|
|
BOOL WINAPI DbgExEnableTag(TRACETAG tag, BOOL fEnable);
|
|
BOOL WINAPI DbgExSetDiskFlag(TRACETAG tag, BOOL fSendToDisk);
|
|
BOOL WINAPI DbgExSetBreakFlag(TRACETAG tag, BOOL fBreak);
|
|
BOOL WINAPI DbgExIsTagEnabled(TRACETAG tag);
|
|
TRACETAG WINAPI DbgExFindTag(char * szTagDesc);
|
|
|
|
TRACETAG WINAPI DbgExTagError();
|
|
TRACETAG WINAPI DbgExTagWarning();
|
|
TRACETAG WINAPI DbgExTagThread();
|
|
TRACETAG WINAPI DbgExTagAssertExit();
|
|
TRACETAG WINAPI DbgExTagAssertStacks();
|
|
TRACETAG WINAPI DbgExTagMemoryStrict();
|
|
TRACETAG WINAPI DbgExTagCoMemoryStrict();
|
|
TRACETAG WINAPI DbgExTagMemoryStrictTail();
|
|
TRACETAG WINAPI DbgExTagMemoryStrictAlign();
|
|
TRACETAG WINAPI DbgExTagOLEWatch();
|
|
TRACETAG WINAPI DbgExTagRegisterTrace(CHAR * szOwner, CHAR * szDescrip, BOOL fEnabled);
|
|
TRACETAG WINAPI DbgExTagRegisterOther(CHAR * szOwner, CHAR * szDescrip, BOOL fEnabled);
|
|
TRACETAG WINAPI DbgExTagPerf();
|
|
|
|
BOOL __cdecl DbgExTaggedTrace(TRACETAG tag, CHAR * szFmt, ...);
|
|
BOOL __cdecl DbgExTaggedTraceEx(TRACETAG tag, USHORT usFlags, CHAR * szFmt, ...);
|
|
BOOL WINAPI DbgExTaggedTraceListEx(TRACETAG tag, USHORT usFlags, CHAR * szFmt, va_list valMarker);
|
|
void WINAPI DbgExTaggedTraceCallers(TRACETAG tag, int iStart, int cTotal);
|
|
|
|
BOOL WINAPI DbgExAssertImpl(char const * szFile, int iLine, char const * szMessage);
|
|
void WINAPI DbgExAssertThreadDisable(BOOL fDisable);
|
|
HRESULT __cdecl DbgExCheckAndReturnResult(HRESULT hr, BOOL fTrace, LPSTR pstrFile, UINT line, int cHResult, ...);
|
|
HRESULT WINAPI DbgExCheckAndReturnResultList(HRESULT hr, BOOL fTrace, LPSTR pstrFile, UINT line, int cHResult, va_list valMarker);
|
|
|
|
size_t WINAPI DbgExPreAlloc(size_t cbRequest);
|
|
void * WINAPI DbgExPostAlloc(void *pv);
|
|
void * WINAPI DbgExPreFree(void *pv);
|
|
void WINAPI DbgExPostFree();
|
|
size_t WINAPI DbgExPreRealloc(void *pvRequest, size_t cbRequest, void **ppv);
|
|
void * WINAPI DbgExPostRealloc(void *pv);
|
|
void * WINAPI DbgExPreGetSize(void *pvRequest);
|
|
size_t WINAPI DbgExPostGetSize(size_t cb);
|
|
void * WINAPI DbgExPreDidAlloc(void *pvRequest);
|
|
BOOL WINAPI DbgExPostDidAlloc(void *pvRequest, BOOL fActual);
|
|
|
|
void WINAPI DbgExMemoryTrackDisable(BOOL fDisable);
|
|
void WINAPI DbgExCoMemoryTrackDisable(BOOL fDisable);
|
|
void WINAPI DbgExMemoryBlockTrackDisable(void * pv);
|
|
void WINAPI DbgExMemSetHeader(void * pvRequest, size_t cb, PERFMETERTAG mt);
|
|
void * WINAPI DbgExGetMallocSpy();
|
|
void WINAPI DbgExTraceMemoryLeaks();
|
|
BOOL WINAPI DbgExValidateInternalHeap();
|
|
|
|
LONG_PTR WINAPI DbgExTraceFailL(LONG_PTR errExpr, LONG_PTR errTest, BOOL fIgnore, LPSTR pstrExpr, LPSTR pstrFile, int line);
|
|
LONG_PTR WINAPI DbgExTraceWin32L(LONG_PTR errExpr, LONG_PTR errTest, BOOL fIgnore, LPSTR pstrExpr, LPSTR pstrFile, int line);
|
|
HRESULT WINAPI DbgExTraceHR(HRESULT hrTest, BOOL fIgnore, LPSTR pstrExpr, LPSTR pstrFile, int line);
|
|
HRESULT WINAPI DbgExTraceOLE(HRESULT hrTest, BOOL fIgnore, LPSTR pstrExpr, LPSTR pstrFile, int line, LPVOID lpsite);
|
|
void WINAPI DbgExTraceEnter(LPSTR pstrExpr, LPSTR pstrFile, int line);
|
|
void WINAPI DbgExTraceExit(LPSTR pstrExpr, LPSTR pstrFile, int line);
|
|
void WINAPI DbgExSetSimFailCounts(int firstFailure, int cInterval);
|
|
void WINAPI DbgExShowSimFailDlg();
|
|
BOOL WINAPI DbgExFFail();
|
|
int WINAPI DbgExGetFailCount();
|
|
void WINAPI DbgExTrackItf(REFIID iid, char * pch, BOOL fTrackOnQI, void **ppv);
|
|
|
|
void WINAPI DbgExOpenViewObjectMonitor(HWND hwndOwner, IUnknown *pUnk, BOOL fUseFrameSize);
|
|
void WINAPI DbgExOpenMemoryMonitor();
|
|
void WINAPI DbgExOpenLogFile(LPCSTR szFName);
|
|
|
|
void * __cdecl DbgExMemSetName(void *pvRequest, char * szFmt, ...);
|
|
void * WINAPI DbgExMemSetNameList(void * pvRequest, char * szFmt, va_list valMarker);
|
|
char * WINAPI DbgExMemGetName(void *pvRequest);
|
|
|
|
HRESULT WINAPI DbgExWsClear(HANDLE hProcess);
|
|
HRESULT WINAPI DbgExWsTakeSnapshot(HANDLE hProcess);
|
|
BSTR WINAPI DbgExWsGetModule(long row);
|
|
BSTR WINAPI DbgExWsGetSection(long row);
|
|
long WINAPI DbgExWsSize(long row);
|
|
long WINAPI DbgExWsCount();
|
|
long WINAPI DbgExWsTotal();
|
|
HRESULT WINAPI DbgExWsStartDelta(HANDLE hProcess);
|
|
long WINAPI DbgExWsEndDelta(HANDLE hProcess);
|
|
|
|
void WINAPI DbgExDumpProcessHeaps();
|
|
|
|
PERFTAG WINAPI DbgExPerfRegister(char * szTag, char * szOwner, char * szDescrip);
|
|
void __cdecl DbgExPerfLogFn(PERFTAG tag, void * pvObj, const char * pchFmt, ...);
|
|
void WINAPI DbgExPerfLogFnList(PERFTAG tag, void * pvObj, const char * pchFmt, va_list valMarker);
|
|
void WINAPI DbgExPerfDump();
|
|
void WINAPI DbgExPerfClear();
|
|
void WINAPI DbgExPerfTags();
|
|
void WINAPI DbgExPerfEnable(BOOL fEnable);
|
|
|
|
char * WINAPI DbgExDecodeMessage(UINT msg);
|
|
|
|
PERFMETERTAG WINAPI DbgExMtRegister(char * szTag, char * szOwner, char * szDescrip);
|
|
void WINAPI DbgExMtAdd(PERFMETERTAG mt, LONG lCnt, LONG_PTR lVal);
|
|
void WINAPI DbgExMtSet(PERFMETERTAG mt, LONG lCnt, LONG_PTR lVal);
|
|
char * WINAPI DbgExMtGetName(PERFMETERTAG mt);
|
|
char * WINAPI DbgExMtGetDesc(PERFMETERTAG mt);
|
|
BOOL WINAPI DbgExMtSimulateOutOfMemory(PERFMETERTAG mt, LONG_PTR lNewValue);
|
|
void WINAPI DbgExMtOpenMonitor();
|
|
void WINAPI DbgExMtLogDump(LPSTR pchFile);
|
|
PERFMETERTAG WINAPI DbgExMtLookupMeter(char * szTag);
|
|
long WINAPI DbgExMtGetMeterCnt(PERFMETERTAG mt, BOOL fExclusive);
|
|
long WINAPI DbgExMtGetMeterVal(PERFMETERTAG mt, BOOL fExclusive);
|
|
|
|
void WINAPI DbgExSetTopUrl(LPWSTR pstrUrl);
|
|
void WINAPI DbgExGetSymbolFromAddress(void * pvAddr, char * pszBuf, DWORD cchBuf);
|
|
|
|
BOOL WINAPI DbgExGetChkStkFill(DWORD * pdwFill);
|
|
int WINAPI DbgExGetStackTrace(int iStart, int cTotal, BYTE *pbBuffer, int cbBuffer, int cchModule, int cchSymbol);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
// Performance Logging --------------------------------------------------------
|
|
|
|
#ifdef PERFTAGS
|
|
|
|
#define IsPerfEnabled(tag) (*(BOOL *)tag)
|
|
#define PerfTag(tag, szOwner, szDescrip) PERFTAG tag(DbgExPerfRegister(#tag, szOwner, szDescrip));
|
|
#define PerfExtern(tag) extern PERFTAG tag;
|
|
#define PerfLog(tag,pv,f) IsPerfEnabled(tag) ? DbgExPerfLogFn(tag,pv,f) : 0
|
|
#define PerfLog1(tag,pv,f,a1) IsPerfEnabled(tag) ? DbgExPerfLogFn(tag,pv,f,a1) : 0
|
|
#define PerfLog2(tag,pv,f,a1,a2) IsPerfEnabled(tag) ? DbgExPerfLogFn(tag,pv,f,a1,a2) : 0
|
|
#define PerfLog3(tag,pv,f,a1,a2,a3) IsPerfEnabled(tag) ? DbgExPerfLogFn(tag,pv,f,a1,a2,a3) : 0
|
|
#define PerfLog4(tag,pv,f,a1,a2,a3,a4) IsPerfEnabled(tag) ? DbgExPerfLogFn(tag,pv,f,a1,a2,a3,a4) : 0
|
|
#define PerfLog5(tag,pv,f,a1,a2,a3,a4,a5) IsPerfEnabled(tag) ? DbgExPerfLogFn(tag,pv,f,a1,a2,a3,a4,a5) : 0
|
|
#define PerfLog6(tag,pv,f,a1,a2,a3,a4,a5,a6) IsPerfEnabled(tag) ? DbgExPerfLogFn(tag,pv,f,a1,a2,a3,a4,a5,a6) : 0
|
|
#define PerfLog7(tag,pv,f,a1,a2,a3,a4,a5,a6,a7) IsPerfEnabled(tag) ? DbgExPerfLogFn(tag,pv,f,a1,a2,a3,a4,a5,a6,a7) : 0
|
|
#define PerfLog8(tag,pv,f,a1,a2,a3,a4,a5,a6,a7,a8) IsPerfEnabled(tag) ? DbgExPerfLogFn(tag,pv,f,a1,a2,a3,a4,a5,a6,a7,a8) : 0
|
|
#define PerfLog9(tag,pv,f,a1,a2,a3,a4,a5,a6,a7,a8,a9) IsPerfEnabled(tag) ? DbgExPerfLogFn(tag,pv,f,a1,a2,a3,a4,a5,a6,a7,a8,a9) : 0
|
|
#define PerfDump() DbgExPerfDump()
|
|
#define PerfClear() DbgExPerfClear()
|
|
#define PerfTags() DbgExPerfTags()
|
|
#define PerfEnable(fEnable) DbgExPerfEnable(fEnable)
|
|
|
|
#else
|
|
|
|
#define IsPerfEnabled(tag) (FALSE)
|
|
#define PerfTag(tag, szOwner, szDescrip)
|
|
#define PerfExtern(tag)
|
|
#define PerfLog(tag,pv,f)
|
|
#define PerfLog1(tag,pv,f,a1)
|
|
#define PerfLog2(tag,pv,f,a1,a2)
|
|
#define PerfLog3(tag,pv,f,a1,a2,a3)
|
|
#define PerfLog4(tag,pv,f,a1,a2,a3,a4)
|
|
#define PerfLog5(tag,pv,f,a1,a2,a3,a4,a5)
|
|
#define PerfLog6(tag,pv,f,a1,a2,a3,a4,a5,a6)
|
|
#define PerfLog7(tag,pv,f,a1,a2,a3,a4,a5,a6,a7)
|
|
#define PerfLog8(tag,pv,f,a1,a2,a3,a4,a5,a6,a7,a8)
|
|
#define PerfLog9(tag,pv,f,a1,a2,a3,a4,a5,a6,a7,a8,a9)
|
|
#define PerfDump()
|
|
#define PerfClear()
|
|
#define PerfTags()
|
|
#define PerfEnable(fEnable)
|
|
|
|
#endif
|
|
|
|
// Performance Metering -------------------------------------------------------
|
|
|
|
#ifdef PERFMETER
|
|
|
|
#define Mt(x) g_mt##x
|
|
#define MtExtern(tag) extern PERFMETERTAG g_mt##tag;
|
|
#define MtDefine(tag, tagOwner, szDescrip) PERFMETERTAG g_mt##tag(DbgExMtRegister("mt" #tag, "mt" #tagOwner, szDescrip));
|
|
#define MtAdd(mt, lCnt, lVal) DbgExMtAdd(mt, lCnt, lVal)
|
|
#define MtSet(mt, lCnt, lVal) DbgExMtSet(mt, lCnt, lVal)
|
|
#define MtSimulateOutOfMemory(mt, lNewVal) DbgExMtSimulateOutOfMemory(mt, lNewVal)
|
|
#define MtOpenMonitor() DbgExMtOpenMonitor()
|
|
|
|
#else
|
|
|
|
#define Mt(x) ((PERFMETERTAG)0)
|
|
#define MtExtern(tag)
|
|
#define MtDefine(tag, szOwner, szDescrip)
|
|
#define MtAdd(mt, lCnt, lVal)
|
|
#define MtSet(mt, lCnt, lVal)
|
|
#define MtSimulateOutOfMemory(mt, lNewValue)
|
|
#define MtOpenMonitor()
|
|
|
|
#endif
|
|
|
|
// MSHTML perf control --------------------------------------------------------
|
|
|
|
#define HTMPERFCTL_NAME "#MSHTML#PERF#"
|
|
|
|
enum
|
|
{
|
|
HTMPF_CALLBACK_ONLOAD = 0x00000001, // callback when topdoc loaded (dwArg1:HTMPF_CALLBACK_ONLOAD, dwArg2: strURL)
|
|
HTMPF_ENABLE_PROFILE = 0x00000002, // enable profiling
|
|
HTMPF_ENABLE_MEMWATCH = 0x00000004, // enable memwatch sampling
|
|
HTMPF_DISABLE_PADEVENTS = 0x00000008, // disable firing of events from mshtmpad.exe
|
|
HTMPF_DISABLE_IMGCACHE = 0x00000010, // disable image cache in mshtml
|
|
HTMPF_DISABLE_OFFSCREEN = 0x00000020, // disable offscreen buffering
|
|
HTMPF_DISABLE_ALERTS = 0x00000040, // disable alert() and confirm() methods
|
|
HTMPF_SYNC_DATABIND = 0x00000080, // grab all records at once for databinding
|
|
HTMPF_CALLBACK_ONLOAD2 = 0x00000100, // callback when topdoc loaded (dwArg1:HTMPF_CALLBACK_ONLOAD, dwArg2: CDoc IUnk)
|
|
HTMPF_CALLBACK_ONVIEWQ = 0x00000200, // callback when ensure view is queued (dwArg1: HTMPF_CALLBACK_ONVIEWQ, dwArg2: CDoc IUnk)
|
|
HTMPF_CALLBACK_ONVIEWD = 0x00000400, // callback when ensure view is dequeued (dwArg1: HTMPF_CALLBACK_ONVIEWD, dwArg2: CDoc IUnk)
|
|
#ifndef NO_ETW_TRACING
|
|
HTMPF_CALLBACK_ONEVENT = 0x00000800 // callback when event tracing for windows is enabled
|
|
// (dwArg1: UCHAR EVENT-TYPE, dwArg2: WCHAR* URL)
|
|
// See shlwapi.w for event types.
|
|
#endif
|
|
};
|
|
|
|
typedef void (WINAPI *HTMPFCBFN)(DWORD dwArg1, void * pvArg2);
|
|
|
|
typedef struct HTMPERFCTL
|
|
{
|
|
DWORD dwSize; // set to sizeof(MSHTMLPERF)
|
|
DWORD dwFlags; // see HTMPF_*
|
|
HTMPFCBFN pfnCall; // Callback function
|
|
void * pvHost; // Private data for host
|
|
} HTMPERFCTL;
|
|
|
|
#endif
|