Skip tests without error if psapi.dll could not be loaded.
[wine] / dlls / kernel / toolhelp.h
1 /*
2  * Copyright (C) the Wine project
3  *
4  * This library is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2.1 of the License, or (at your option) any later version.
8  *
9  * This library is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU Lesser General Public
15  * License along with this library; if not, write to the Free Software
16  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
17  */
18
19 #ifndef __WINE_TOOLHELP_H
20 #define __WINE_TOOLHELP_H
21
22 #include <windef.h>
23 #include <wine/windef16.h>
24
25 #define MAX_DATA        11
26 #define MAX_MODULE_NAME 9
27 #define MAX_PATH16      255
28 #define MAX_CLASSNAME   255
29
30 #include <pshpack1.h>
31
32 /* Global heap */
33
34 typedef struct
35 {
36     DWORD dwSize;
37     WORD  wcItems;
38     WORD  wcItemsFree;
39     WORD  wcItemsLRU;
40 } GLOBALINFO;
41
42 typedef struct
43 {
44     DWORD     dwSize;
45     DWORD     dwAddress;
46     DWORD     dwBlockSize;
47     HGLOBAL16 hBlock;
48     WORD      wcLock;
49     WORD      wcPageLock;
50     WORD      wFlags;
51     BOOL16    wHeapPresent;
52     HGLOBAL16 hOwner;
53     WORD      wType;
54     WORD      wData;
55     DWORD     dwNext;
56     DWORD     dwNextAlt;
57 } GLOBALENTRY;
58
59   /* GlobalFirst()/GlobalNext() flags */
60 #define GLOBAL_ALL      0
61 #define GLOBAL_LRU      1
62 #define GLOBAL_FREE     2
63
64   /* wType values */
65 #define GT_UNKNOWN      0
66 #define GT_DGROUP       1
67 #define GT_DATA         2
68 #define GT_CODE         3
69 #define GT_TASK         4
70 #define GT_RESOURCE     5
71 #define GT_MODULE       6
72 #define GT_FREE         7
73 #define GT_INTERNAL     8
74 #define GT_SENTINEL     9
75 #define GT_BURGERMASTER 10
76
77 /* wData values */
78 #define GD_USERDEFINED      0
79 #define GD_CURSORCOMPONENT  1
80 #define GD_BITMAP           2
81 #define GD_ICONCOMPONENT    3
82 #define GD_MENU             4
83 #define GD_DIALOG           5
84 #define GD_STRING           6
85 #define GD_FONTDIR          7
86 #define GD_FONT             8
87 #define GD_ACCELERATORS     9
88 #define GD_RCDATA           10
89 #define GD_ERRTABLE         11
90 #define GD_CURSOR           12
91 #define GD_ICON             14
92 #define GD_NAMETABLE        15
93 #define GD_MAX_RESOURCE     15
94
95 /* wFlags values */
96 #define GF_PDB_OWNER        0x0100      /* Low byte is KERNEL flags */
97
98 WORD   WINAPI GlobalHandleToSel16( HGLOBAL16 handle );
99 BOOL16 WINAPI GlobalInfo16( GLOBALINFO *pInfo );
100 BOOL16 WINAPI GlobalFirst16( GLOBALENTRY *pGlobal, WORD wFlags );
101 BOOL16 WINAPI GlobalNext16( GLOBALENTRY *pGlobal, WORD wFlags) ;
102 BOOL16 WINAPI GlobalEntryHandle16( GLOBALENTRY *pGlobal, HGLOBAL16 hItem );
103 BOOL16 WINAPI GlobalEntryModule16( GLOBALENTRY *pGlobal, HMODULE16 hModule,
104                                  WORD wSeg );
105
106 /* FIXME: Wine internal functions */
107 extern HGLOBAL16 GLOBAL_CreateBlock( UINT16 flags, const void *ptr, DWORD size,
108                                      HGLOBAL16 hOwner, unsigned char selflags );
109 extern BOOL16 GLOBAL_FreeBlock( HGLOBAL16 handle );
110 extern BOOL16 GLOBAL_MoveBlock( HGLOBAL16 handle, const void *ptr, DWORD size );
111 extern HGLOBAL16 GLOBAL_Alloc( WORD flags, DWORD size, HGLOBAL16 hOwner, unsigned char selflags );
112
113 /* Local heap */
114
115 typedef struct
116 {
117     DWORD   dwSize;
118     WORD    wcItems;
119 } LOCALINFO;
120
121 typedef struct
122 {
123     DWORD   dwSize;
124     HLOCAL16  hHandle;
125     WORD    wAddress;
126     WORD    wSize;
127     WORD    wFlags;
128     WORD    wcLock;
129     WORD    wType;
130     WORD    hHeap;
131     WORD    wHeapType;
132     WORD    wNext;
133 } LOCALENTRY;
134
135 /* wHeapType values */
136 #define NORMAL_HEAP     0
137 #define USER_HEAP       1
138 #define GDI_HEAP        2
139
140 /* wFlags values */
141 #define LF_FIXED        1
142 #define LF_FREE         2
143 #define LF_MOVEABLE     4
144
145 /* wType values */
146 #define LT_NORMAL                   0
147 #define LT_FREE                     0xff
148 #define LT_GDI_PEN                  1   /* LT_GDI_* is for GDI's heap */
149 #define LT_GDI_BRUSH                2
150 #define LT_GDI_FONT                 3
151 #define LT_GDI_PALETTE              4
152 #define LT_GDI_BITMAP               5
153 #define LT_GDI_RGN                  6
154 #define LT_GDI_DC                   7
155 #define LT_GDI_DISABLED_DC          8
156 #define LT_GDI_METADC               9
157 #define LT_GDI_METAFILE             10
158 #define LT_GDI_MAX                  LT_GDI_METAFILE
159 #define LT_USER_CLASS               1   /* LT_USER_* is for USER's heap */
160 #define LT_USER_WND                 2
161 #define LT_USER_STRING              3
162 #define LT_USER_MENU                4
163 #define LT_USER_CLIP                5
164 #define LT_USER_CBOX                6
165 #define LT_USER_PALETTE             7
166 #define LT_USER_ED                  8
167 #define LT_USER_BWL                 9
168 #define LT_USER_OWNERDRAW           10
169 #define LT_USER_SPB                 11
170 #define LT_USER_CHECKPOINT          12
171 #define LT_USER_DCE                 13
172 #define LT_USER_MWP                 14
173 #define LT_USER_PROP                15
174 #define LT_USER_LBIV                16
175 #define LT_USER_MISC                17
176 #define LT_USER_ATOMS               18
177 #define LT_USER_LOCKINPUTSTATE      19
178 #define LT_USER_HOOKLIST            20
179 #define LT_USER_USERSEEUSERDOALLOC  21
180 #define LT_USER_HOTKEYLIST          22
181 #define LT_USER_POPUPMENU           23
182 #define LT_USER_HANDLETABLE         32
183 #define LT_USER_MAX                 LT_USER_HANDLETABLE
184
185 BOOL16 WINAPI LocalInfo16( LOCALINFO *pLocalInfo, HGLOBAL16 handle );
186 BOOL16 WINAPI LocalFirst16( LOCALENTRY *pLocalEntry, HGLOBAL16 handle );
187 BOOL16 WINAPI LocalNext16( LOCALENTRY *pLocalEntry );
188
189 /* Local 32-bit heap */
190
191 typedef struct
192 {
193     DWORD dwSize;                /* 00 */
194     DWORD dwMemReserved;         /* 04 */
195     DWORD dwMemCommitted;        /* 08 */
196     DWORD dwTotalFree;           /* 0C */
197     DWORD dwLargestFreeBlock;    /* 10 */
198     DWORD dwcFreeHandles;        /* 14 */
199 } LOCAL32INFO;
200
201 typedef struct
202 {
203     DWORD dwSize;                /* 00 */
204     WORD hHandle;                /* 04 */
205     DWORD dwAddress;             /* 06 */
206     DWORD dwSizeBlock;           /* 0A */
207     WORD wFlags;                 /* 0E */
208     WORD wType;                  /* 10 */
209     WORD hHeap;                  /* 12 */
210     WORD wHeapType;              /* 14 */
211     DWORD dwNext;                /* 16 */
212     DWORD dwNextAlt;             /* 1A */
213 } LOCAL32ENTRY;
214
215 /* LOCAL32ENTRY.wHeapType flags same as LOCALENTRY.wHeapType flags */
216 /* LOCAL32ENTRY.wFlags same as LOCALENTRY.wFlags */
217 /* LOCAL32ENTRY.wType same as LOCALENTRY.wType */
218
219 BOOL16 WINAPI Local32Info16( LOCAL32INFO *pLocal32Info, HGLOBAL16 handle );
220 BOOL16 WINAPI Local32First16( LOCAL32ENTRY *pLocal32Entry, HGLOBAL16 handle );
221 BOOL16 WINAPI Local32Next16( LOCAL32ENTRY *pLocal32Entry );
222
223
224 /* modules */
225
226 typedef struct
227 {
228     DWORD      dwSize;
229     char       szModule[MAX_MODULE_NAME + 1];
230     HMODULE16  hModule;
231     WORD       wcUsage;
232     char       szExePath[MAX_PATH16 + 1];
233     HANDLE16   wNext;
234 } MODULEENTRY, *LPMODULEENTRY;
235
236 BOOL16 WINAPI ModuleFirst16(MODULEENTRY *lpModule);
237 BOOL16 WINAPI ModuleNext16(MODULEENTRY *lpModule);
238 BOOL16 WINAPI ModuleFindName16(MODULEENTRY *lpModule, LPCSTR lpstrName);
239 BOOL16 WINAPI ModuleFindHandle16(MODULEENTRY *lpModule, HMODULE16 hModule);
240
241 /* tasks */
242
243 typedef struct
244 {
245     DWORD        dwSize;
246     HTASK16      hTask;
247     HTASK16      hTaskParent;
248     HINSTANCE16  hInst;
249     HMODULE16    hModule;
250     WORD         wSS;
251     WORD         wSP;
252     WORD         wStackTop;
253     WORD         wStackMinimum;
254     WORD         wStackBottom;
255     WORD         wcEvents;
256     HGLOBAL16    hQueue;
257     char         szModule[MAX_MODULE_NAME + 1];
258     WORD         wPSPOffset;
259     HANDLE16     hNext;
260 } TASKENTRY, *LPTASKENTRY;
261
262 BOOL16 WINAPI TaskFirst16(LPTASKENTRY lpTask);
263 BOOL16 WINAPI TaskNext16(LPTASKENTRY lpTask);
264 BOOL16 WINAPI TaskFindHandle16(LPTASKENTRY lpTask, HTASK16 hTask);
265 DWORD  WINAPI TaskSetCSIP(HTASK16 hTask, WORD wCS, WORD wIP);
266 DWORD  WINAPI TaskGetCSIP(HTASK16 hTask);
267 BOOL16 WINAPI TaskSwitch(HTASK16 hTask, DWORD dwNewCSIP);
268
269 /* flag for TerminateApp16() */
270 #define NO_UAE_BOX     1
271
272 /* mem info */
273
274 typedef struct tagMEMMANINFO {
275         DWORD dwSize;
276         DWORD dwLargestFreeBlock;
277         DWORD dwMaxPagesAvailable;
278         DWORD dwMaxPagesLockable;
279         DWORD dwTotalLinearSpace;
280         DWORD dwTotalUnlockedPages;
281         DWORD dwFreePages;
282         DWORD dwTotalPages;
283         DWORD dwFreeLinearSpace;
284         DWORD dwSwapFilePages;
285         WORD wPageSize;
286 } MEMMANINFO;
287 typedef MEMMANINFO *LPMEMMANINFO;
288
289 typedef struct
290 {
291     DWORD     dwSize;
292     WORD      wUserFreePercent;
293     WORD      wGDIFreePercent;
294     HGLOBAL16 hUserSegment;
295     HGLOBAL16 hGDISegment;
296 } SYSHEAPINFO;
297
298 BOOL16 WINAPI MemManInfo16(LPMEMMANINFO lpEnhMode);
299 BOOL16 WINAPI SystemHeapInfo16( SYSHEAPINFO *pHeapInfo );
300
301 /* timer info */
302
303 typedef struct tagTIMERINFO {
304         DWORD dwSize;
305         DWORD dwmsSinceStart;
306         DWORD dwmsThisVM;
307 } TIMERINFO;
308
309 BOOL16 WINAPI TimerCount16( TIMERINFO *pTimerInfo );
310
311 /* Window classes */
312
313 typedef struct
314 {
315     DWORD     dwSize;
316     HMODULE16 hInst;              /* This is really an hModule */
317     char      szClassName[MAX_CLASSNAME + 1];
318     HANDLE16  wNext;
319 } CLASSENTRY;
320
321 BOOL16 WINAPI ClassFirst16( CLASSENTRY *pClassEntry );
322 BOOL16 WINAPI ClassNext16( CLASSENTRY *pClassEntry );
323
324
325 /* Memory read/write */
326
327 DWORD WINAPI MemoryRead16( WORD sel, DWORD offset, void *buffer, DWORD count );
328 DWORD WINAPI MemoryWrite16( WORD sel, DWORD offset, void *buffer, DWORD count );
329
330 /* flags to NotifyRegister() */
331 #define NF_NORMAL       0       /* everything except taskswitches, debugerrors,
332                                  * debugstrings
333                                  */
334 #define NF_TASKSWITCH   1       /* get taskswitch information */
335 #define NF_RIP          2       /* get debugerrors of system */
336
337 BOOL16 WINAPI NotifyRegister16(HTASK16 htask,FARPROC16 lpfnCallback,WORD wFlags);
338
339 #define NFY_UNKNOWN     0
340 #define NFY_LOADSEG     1
341 /* DATA is a pointer to following struct: */
342 typedef struct {
343         DWORD   dwSize;
344         WORD    wSelector;
345         WORD    wSegNum;
346         WORD    wType;          /* bit 0 set if this is a code segment */
347         WORD    wcInstance;     /* only valid for data segment */
348 } NFYLOADSEG;
349 /* called when freeing a segment. LOWORD(dwData) is the freed selector */
350 #define NFY_FREESEG     2
351
352 /* called when loading/starting a DLL */
353 #define NFY_STARTDLL    3
354 typedef struct {
355     DWORD      dwSize;
356     HMODULE16  hModule;
357     WORD       wCS;
358     WORD       wIP;
359 } NFYSTARTDLL;
360
361 /* called when starting a task. dwData is CS:IP */
362 #define NFY_STARTTASK   4
363
364 /* called when a task terminates. dwData is the return code */
365 #define NFY_EXITTASK    5
366
367 /* called when module is removed. LOWORD(dwData) is the handle */
368 #define NFY_DELMODULE   6
369
370 /* RIP? debugevent */
371 #define NFY_RIP         7
372 typedef struct {
373         DWORD   dwSize;
374         WORD    wIP;
375         WORD    wCS;
376         WORD    wSS;
377         WORD    wBP;
378         WORD    wExitCode;
379 } NFYRIP;
380
381 /* called before (after?) switching to a task
382  * no data, callback should call GetCurrentTask
383  */
384 #define NFY_TASKIN      8
385
386 /* called before(after?) switching from a task
387  * no data, callback should call GetCurrentTask
388 */
389 #define NFY_TASKOUT     9
390
391 /* returns ASCII input value, dwData not set */
392 #define NFY_INCHAR      10
393
394 /* output debugstring (pointed to by dwData) */
395 #define NFY_OUTSTRING   11
396
397 /* log errors */
398 #define NFY_LOGERROR    12
399 typedef struct {
400         DWORD   dwSize;
401         UINT16  wErrCode;
402         VOID   *lpInfo; /* depends on wErrCode */
403 } NFYLOGERROR;
404
405 /* called for parameter errors? */
406 #define NFY_LOGPARAMERROR       13
407 typedef struct {
408     DWORD       dwSize;
409     UINT16      wErrCode;
410     FARPROC16   lpfnErrorAddr;
411     void      **lpBadParam;
412 } NFYLOGPARAMERROR;
413
414 typedef struct {
415     DWORD dwSize;
416     HTASK16 hTask;
417     WORD wSS;
418     WORD wBP;
419     WORD wCS;
420     WORD wIP;
421     HMODULE16 hModule;
422     WORD wSegment;
423     WORD wFlags;
424 } STACKTRACEENTRY;
425
426 #include <poppack.h>
427
428 #endif /* __WINE_TOOLHELP_H */