NT4/private/oleauto/tools/win16/hdos/c800/include/toolhelp.h
2020-09-30 17:12:29 +02:00

470 lines
14 KiB
C

/*****************************************************************************\
* *
* toolhelp.h - toolhelp.dll functions, types, and definitions *
* *
* Version 1.0 *
* *
* NOTE: windows.h must be #included first *
* *
* Copyright (c) 1992, Microsoft Corp. All rights reserved. *
* *
\*****************************************************************************/
#ifndef _INC_TOOLHELP
#define _INC_TOOLHELP
#ifndef RC_INVOKED
#pragma pack(1) /* Assume byte packing throughout */
#endif
#ifdef __cplusplus
extern "C" { /* Assume C declarations for C++ */
#endif /* __cplusplus */
#ifndef _INC_WINDOWS /* If included with 3.0 headers... */
#define LPCSTR LPSTR
#define WINAPI FAR PASCAL
#define CALLBACK FAR PASCAL
#define UINT WORD
#define HMODULE HANDLE
#define HINSTANCE HANDLE
#define HLOCAL HANDLE
#define HGLOBAL HANDLE
#define HTASK HANDLE
#endif /* _INC_WINDOWS */
/****** General symbols ******************************************************/
#define MAX_DATA 11
#define MAX_PATH 255
#define MAX_MODULE_NAME 8 + 1
#define MAX_CLASSNAME 255
/****** Global heap walking ***************************************************/
typedef struct tagGLOBALINFO
{
DWORD dwSize;
WORD wcItems;
WORD wcItemsFree;
WORD wcItemsLRU;
} GLOBALINFO;
typedef struct tagGLOBALENTRY
{
DWORD dwSize;
DWORD dwAddress;
DWORD dwBlockSize;
HGLOBAL hBlock;
WORD wcLock;
WORD wcPageLock;
WORD wFlags;
BOOL wHeapPresent;
HGLOBAL hOwner;
WORD wType;
WORD wData;
DWORD dwNext;
DWORD dwNextAlt;
} GLOBALENTRY;
/* GlobalFirst()/GlobalNext() flags */
#define GLOBAL_ALL 0
#define GLOBAL_LRU 1
#define GLOBAL_FREE 2
/* GLOBALENTRY.wType entries */
#define GT_UNKNOWN 0
#define GT_DGROUP 1
#define GT_DATA 2
#define GT_CODE 3
#define GT_TASK 4
#define GT_RESOURCE 5
#define GT_MODULE 6
#define GT_FREE 7
#define GT_INTERNAL 8
#define GT_SENTINEL 9
#define GT_BURGERMASTER 10
/* If GLOBALENTRY.wType==GT_RESOURCE, the following is GLOBALENTRY.wData: */
#define GD_USERDEFINED 0
#define GD_CURSORCOMPONENT 1
#define GD_BITMAP 2
#define GD_ICONCOMPONENT 3
#define GD_MENU 4
#define GD_DIALOG 5
#define GD_STRING 6
#define GD_FONTDIR 7
#define GD_FONT 8
#define GD_ACCELERATORS 9
#define GD_RCDATA 10
#define GD_ERRTABLE 11
#define GD_CURSOR 12
#define GD_ICON 14
#define GD_NAMETABLE 15
#define GD_MAX_RESOURCE 15
/* GLOBALENTRY.wFlags */
#define GF_PDB_OWNER 0x0100 /* Low byte is KERNEL flags */
BOOL WINAPI GlobalInfo(GLOBALINFO FAR* lpGlobalInfo);
BOOL WINAPI GlobalFirst(GLOBALENTRY FAR* lpGlobal, WORD wFlags);
BOOL WINAPI GlobalNext(GLOBALENTRY FAR* lpGlobal, WORD wFlags);
BOOL WINAPI GlobalEntryHandle(GLOBALENTRY FAR* lpGlobal, HGLOBAL hItem);
BOOL WINAPI GlobalEntryModule(GLOBALENTRY FAR* lpGlobal, HMODULE hModule, WORD wSeg);
WORD WINAPI GlobalHandleToSel(HGLOBAL hMem);
/****** Local heap walking ***************************************************/
typedef struct tagLOCALINFO
{
DWORD dwSize;
WORD wcItems;
} LOCALINFO;
typedef struct tagLOCALENTRY
{
DWORD dwSize;
HLOCAL hHandle;
WORD wAddress;
WORD wSize;
WORD wFlags;
WORD wcLock;
WORD wType;
WORD hHeap;
WORD wHeapType;
WORD wNext;
} LOCALENTRY;
/* LOCALENTRY.wHeapType flags */
#define NORMAL_HEAP 0
#define USER_HEAP 1
#define GDI_HEAP 2
/* LOCALENTRY.wFlags */
#define LF_FIXED 1
#define LF_FREE 2
#define LF_MOVEABLE 4
/* LOCALENTRY.wType */
#define LT_NORMAL 0
#define LT_FREE 0xff
#define LT_GDI_PEN 1 /* LT_GDI_* is for GDI's heap */
#define LT_GDI_BRUSH 2
#define LT_GDI_FONT 3
#define LT_GDI_PALETTE 4
#define LT_GDI_BITMAP 5
#define LT_GDI_RGN 6
#define LT_GDI_DC 7
#define LT_GDI_DISABLED_DC 8
#define LT_GDI_METADC 9
#define LT_GDI_METAFILE 10
#define LT_GDI_MAX LT_GDI_METAFILE
#define LT_USER_CLASS 1 /* LT_USER_* is for USER's heap */
#define LT_USER_WND 2
#define LT_USER_STRING 3
#define LT_USER_MENU 4
#define LT_USER_CLIP 5
#define LT_USER_CBOX 6
#define LT_USER_PALETTE 7
#define LT_USER_ED 8
#define LT_USER_BWL 9
#define LT_USER_OWNERDRAW 10
#define LT_USER_SPB 11
#define LT_USER_CHECKPOINT 12
#define LT_USER_DCE 13
#define LT_USER_MWP 14
#define LT_USER_PROP 15
#define LT_USER_LBIV 16
#define LT_USER_MISC 17
#define LT_USER_ATOMS 18
#define LT_USER_LOCKINPUTSTATE 19
#define LT_USER_HOOKLIST 20
#define LT_USER_USERSEEUSERDOALLOC 21
#define LT_USER_HOTKEYLIST 22
#define LT_USER_POPUPMENU 23
#define LT_USER_HANDLETABLE 32
#define LT_USER_MAX LT_USER_HANDLETABLE
BOOL WINAPI LocalInfo(LOCALINFO FAR* lpLocal, HGLOBAL hHeap);
BOOL WINAPI LocalFirst(LOCALENTRY FAR* lpLocal, HGLOBAL hHeap);
BOOL WINAPI LocalNext(LOCALENTRY FAR* lpLocal);
/****** Stack Tracing ********************************************************/
typedef struct tagSTACKTRACEENTRY
{
DWORD dwSize;
HTASK hTask;
WORD wSS;
WORD wBP;
WORD wCS;
WORD wIP;
HMODULE hModule;
WORD wSegment;
WORD wFlags;
} STACKTRACEENTRY;
/* STACKTRACEENTRY.wFlags values */
#define FRAME_FAR 0
#define FRAME_NEAR 1
BOOL WINAPI StackTraceFirst(STACKTRACEENTRY FAR* lpStackTrace, HTASK hTask);
BOOL WINAPI StackTraceCSIPFirst(STACKTRACEENTRY FAR* lpStackTrace,
WORD wSS, WORD wCS, WORD wIP, WORD wBP);
BOOL WINAPI StackTraceNext(STACKTRACEENTRY FAR* lpStackTrace);
/****** Module list walking **************************************************/
typedef struct tagMODULEENTRY
{
DWORD dwSize;
char szModule[MAX_MODULE_NAME + 1];
HMODULE hModule;
WORD wcUsage;
char szExePath[MAX_PATH + 1];
WORD wNext;
} MODULEENTRY;
BOOL WINAPI ModuleFirst(MODULEENTRY FAR* lpModule);
BOOL WINAPI ModuleNext(MODULEENTRY FAR* lpModule);
HMODULE WINAPI ModuleFindName(MODULEENTRY FAR* lpModule, LPCSTR lpstrName);
HMODULE WINAPI ModuleFindHandle(MODULEENTRY FAR* lpModule, HMODULE hModule);
/****** Task list walking *****************************************************/
typedef struct tagTASKENTRY
{
DWORD dwSize;
HTASK hTask;
HTASK hTaskParent;
HINSTANCE hInst;
HMODULE hModule;
WORD wSS;
WORD wSP;
WORD wStackTop;
WORD wStackMinimum;
WORD wStackBottom;
WORD wcEvents;
HGLOBAL hQueue;
char szModule[MAX_MODULE_NAME + 1];
WORD wPSPOffset;
HANDLE hNext;
} TASKENTRY;
BOOL WINAPI TaskFirst(TASKENTRY FAR* lpTask);
BOOL WINAPI TaskNext(TASKENTRY FAR* lpTask);
BOOL WINAPI TaskFindHandle(TASKENTRY FAR* lpTask, HTASK hTask);
DWORD WINAPI TaskSetCSIP(HTASK hTask, WORD wCS, WORD wIP);
DWORD WINAPI TaskGetCSIP(HTASK hTask);
BOOL WINAPI TaskSwitch(HTASK hTask, DWORD dwNewCSIP);
/****** Window Class enumeration **********************************************/
typedef struct tagCLASSENTRY
{
DWORD dwSize;
HMODULE hInst; /* This is really an hModule */
char szClassName[MAX_CLASSNAME + 1];
WORD wNext;
} CLASSENTRY;
BOOL WINAPI ClassFirst(CLASSENTRY FAR* lpClass);
BOOL WINAPI ClassNext(CLASSENTRY FAR* lpClass);
/****** Information functions *************************************************/
typedef struct tagMEMMANINFO
{
DWORD dwSize;
DWORD dwLargestFreeBlock;
DWORD dwMaxPagesAvailable;
DWORD dwMaxPagesLockable;
DWORD dwTotalLinearSpace;
DWORD dwTotalUnlockedPages;
DWORD dwFreePages;
DWORD dwTotalPages;
DWORD dwFreeLinearSpace;
DWORD dwSwapFilePages;
WORD wPageSize;
} MEMMANINFO;
BOOL WINAPI MemManInfo(MEMMANINFO FAR* lpEnhMode);
typedef struct tagSYSHEAPINFO
{
DWORD dwSize;
WORD wUserFreePercent;
WORD wGDIFreePercent;
HGLOBAL hUserSegment;
HGLOBAL hGDISegment;
} SYSHEAPINFO;
BOOL WINAPI SystemHeapInfo(SYSHEAPINFO FAR* lpSysHeap);
/****** Interrupt Handling ****************************************************/
/* Hooked interrupts */
#define INT_DIV0 0
#define INT_1 1
#define INT_3 3
#define INT_UDINSTR 6
#define INT_STKFAULT 12
#define INT_GPFAULT 13
#define INT_BADPAGEFAULT 14
#define INT_CTLALTSYSRQ 256
/* TOOLHELP Interrupt callbacks registered with InterruptRegister should
* always be written in assembly language. The stack frame is not
* compatible with high level language conventions.
*
* This stack frame looks as follows to the callback. All registers
* should be preserved across this callback to allow restarting fault.
* ------------
* | Flags | [SP + 0Eh]
* | CS | [SP + 0Ch]
* | IP | [SP + 0Ah]
* | Handle | [SP + 08h]
* |Exception#| [SP + 06h]
* | AX | [SP + 04h] AX Saved to allow MakeProcInstance
* | Ret CS | [SP + 02h]
* SP---> | Ret IP | [SP + 00h]
* ------------
*/
BOOL WINAPI InterruptRegister(HTASK hTask, FARPROC lpfnIntCallback);
BOOL WINAPI InterruptUnRegister(HTASK hTask);
/* Notifications:
* When a notification callback is called, two parameters are passed
* in: a WORD, wID, and another DWORD, dwData. wID is one of
* the values NFY_* below. Callback routines should ignore unrecog-
* nized values to preserve future compatibility. Callback routines
* are also passed a dwData value. This may contain data or may be
* a FAR pointer to a structure, or may not be used depending on
* which notification is being received.
*
* In all cases, if the return value of the callback is TRUE, the
* notification will NOT be passed on to other callbacks. It has
* been handled. This should be used sparingly and only with certain
* notifications. Callbacks almost always return FALSE.
*/
/* NFY_UNKNOWN: An unknown notification has been returned from KERNEL. Apps
* should ignore these.
*/
#define NFY_UNKNOWN 0
/* NFY_LOADSEG: dwData points to a NFYLOADSEG structure */
#define NFY_LOADSEG 1
typedef struct tagNFYLOADSEG
{
DWORD dwSize;
WORD wSelector;
WORD wSegNum;
WORD wType; /* Low bit set if data seg, clear if code seg */
WORD wcInstance; /* Instance count ONLY VALID FOR DATA SEG */
LPCSTR lpstrModuleName;
} NFYLOADSEG;
/* NFY_FREESEG: LOWORD(dwData) is the selector of the segment being freed */
#define NFY_FREESEG 2
/* NFY_STARTDLL: dwData points to a NFYLOADSEG structure */
#define NFY_STARTDLL 3
typedef struct tagNFYSTARTDLL
{
DWORD dwSize;
HMODULE hModule;
WORD wCS;
WORD wIP;
} NFYSTARTDLL;
/* NFY_STARTTASK: dwData is the CS:IP of the start address of the task */
#define NFY_STARTTASK 4
/* NFY_EXITTASK: The low byte of dwData contains the program exit code */
#define NFY_EXITTASK 5
/* NFY_DELMODULE: LOWORD(dwData) is the handle of the module to be freed */
#define NFY_DELMODULE 6
/* NFY_RIP: dwData points to a NFYRIP structure */
#define NFY_RIP 7
typedef struct tagNFYRIP
{
DWORD dwSize;
WORD wIP;
WORD wCS;
WORD wSS;
WORD wBP;
WORD wExitCode;
} NFYRIP;
/* NFY_TASKIN: No data. Callback should do GetCurrentTask() */
#define NFY_TASKIN 8
/* NFY_TASKOUT: No data. Callback should do GetCurrentTask() */
#define NFY_TASKOUT 9
/* NFY_INCHAR: Return value from callback is used. If NULL, mapped to 'i' */
#define NFY_INCHAR 10
/* NFY_OUTSTR: dwData points to the string to be displayed */
#define NFY_OUTSTR 11
/* NFY_LOGERROR: dwData points to a NFYLOGERROR struct */
#define NFY_LOGERROR 12
typedef struct tagNFYLOGERROR
{
DWORD dwSize;
UINT wErrCode;
void FAR* lpInfo; /* Error code-dependent */
} NFYLOGERROR;
/* NFY_LOGPARAMERROR: dwData points to a NFYLOGPARAMERROR struct */
#define NFY_LOGPARAMERROR 13
typedef struct tagNFYLOGPARAMERROR
{
DWORD dwSize;
UINT wErrCode;
FARPROC lpfnErrorAddr;
void FAR* FAR* lpBadParam;
} NFYLOGPARAMERROR;
/* NotifyRegister() flags */
#define NF_NORMAL 0
#define NF_TASKSWITCH 1
#define NF_RIP 2
typedef BOOL (CALLBACK* LPFNNOTIFYCALLBACK)(WORD wID, DWORD dwData);
BOOL WINAPI NotifyRegister(HTASK hTask, LPFNNOTIFYCALLBACK lpfn, WORD wFlags);
BOOL WINAPI NotifyUnRegister(HTASK hTask);
/****** Miscellaneous *********************************************************/
void WINAPI TerminateApp(HTASK hTask, WORD wFlags);
/* TerminateApp() flag values */
#define UAE_BOX 0
#define NO_UAE_BOX 1
DWORD WINAPI MemoryRead(WORD wSel, DWORD dwOffset, void FAR* lpBuffer, DWORD dwcb);
DWORD WINAPI MemoryWrite(WORD wSel, DWORD dwOffset, void FAR* lpBuffer, DWORD dwcb);
typedef struct tagTIMERINFO
{
DWORD dwSize;
DWORD dwmsSinceStart;
DWORD dwmsThisVM;
} TIMERINFO;
BOOL WINAPI TimerCount(TIMERINFO FAR* lpTimer);
#ifdef __cplusplus
}
#endif /* __cplusplus */
#ifndef RC_INVOKED
#pragma pack() /* Revert to default packing */
#endif
#endif /* !_INC_TOOLHELP */