include/task.h

   1 /*
   2  * Task definitions
   3  *
   4  * Copyright 1995 Alexandre Julliard
   5  */
   6
   7 #ifndef __WINE_TASK_H
   8 #define __WINE_TASK_H
   9
  10 #include "wintypes.h"
  11
  12 #pragma pack(1)
  13
  14   /* Process database (i.e. a normal DOS PSP) */
  15
  16 typedef struct
  17 {
  18     WORD      int20;                   /* 00 int 20h instruction */
  19     WORD      nextParagraph;           /* 02 Segment of next paragraph */
  20     BYTE      reserved1;
  21     BYTE      dispatcher[5];           /* 05 Long call to DOS */
  22     FARPROC16 savedint22 WINE_PACKED;  /* 0a Saved int 22h handler */
  23     FARPROC16 savedint23 WINE_PACKED;  /* 0e Saved int 23h handler */
  24     FARPROC16 savedint24 WINE_PACKED;  /* 12 Saved int 24h handler */
  25     WORD      parentPSP;               /* 16 Selector of parent PSP */
  26     BYTE      fileHandles[20];         /* 18 Open file handles */
  27     HANDLE16  environment;             /* 2c Selector of environment */
  28     WORD      reserved2[2];
  29     WORD      nbFiles;                 /* 32 Number of file handles */
  30     SEGPTR    fileHandlesPtr;          /* 34 Pointer to file handle table */
  31     HANDLE16  hFileHandles;            /* 38 Handle to fileHandlesPtr */
  32     WORD      reserved3[17];
  33     BYTE      fcb1[16];                /* 5c First FCB */
  34     BYTE      fcb2[20];                /* 6c Second FCB */
  35     BYTE      cmdLine[128];            /* 80 Command-line (first byte is len)*/
  36     BYTE      padding[16];             /* Some apps access beyond the end of the cmd line */
  37 } PDB;
  38
  39
  40   /* Segment containing MakeProcInstance() thunks */
  41 typedef struct
  42 {
  43     WORD  next;       /* Selector of next segment */
  44     WORD  magic;      /* Thunks signature */
  45     WORD  unused;
  46     WORD  free;       /* Head of the free list */
  47     WORD  thunks[4];  /* Each thunk is 4 words long */
  48 } THUNKS;
  49
  50 #define THUNK_MAGIC  ('P' | ('T' << 8))
  51
  52 struct _THDB;
  53 struct _WSINFO;
  54 struct _NE_MODULE;
  55
  56   /* signal proc typedef */
  57 typedef void (CALLBACK *USERSIGNALPROC)(HANDLE16, UINT16, UINT16,
  58                                         HINSTANCE16, HQUEUE16);
  59
  60   /* Task database. See 'Windows Internals' p. 226.
  61    * Note that 16-bit OLE 2 libs like to read it directly
  62    * so we have to keep entry offsets as they are.
  63    */
  64 typedef struct _TDB
  65 {
  66     HTASK16   hNext;                      /* 00 Selector of next TDB */
  67     DWORD     ss_sp WINE_PACKED;          /* 02 Stack pointer of task */
  68     WORD      nEvents;                    /* 06 Events for this task */
  69     INT16     priority;                   /* 08 Task priority, -32..15 */
  70     WORD      unused1;                    /* 0a */
  71     HTASK16   hSelf;                      /* 0c Selector of this TDB */
  72     HANDLE16  hPrevInstance;              /* 0e Previous instance of module */
  73     DWORD     unused2;                    /* 10 */
  74     WORD      ctrlword8087;               /* 14 80x87 control word */
  75     WORD      flags;                      /* 16 Task flags */
  76     UINT16    error_mode;                 /* 18 Error mode (see SetErrorMode)*/
  77     WORD      version;                    /* 1a Expected Windows version */
  78     HANDLE16  hInstance;                  /* 1c Instance handle for task */
  79     HMODULE16 hModule;                    /* 1e Module handle */
  80     HQUEUE16  hQueue;                     /* 20 Selector of task queue */
  81     HTASK16   hParent;                    /* 22 Selector of TDB of parent */
  82     WORD      signal_flags;               /* 24 Flags for signal handler */
  83     FARPROC16 sighandler WINE_PACKED;     /* 26 Signal handler */
  84     USERSIGNALPROC userhandler WINE_PACKED; /* 2a USER signal handler */
  85     FARPROC16 discardhandler WINE_PACKED; /* 2e Handler for GlobalNotify() */
  86     DWORD     int0 WINE_PACKED;           /* 32 int 0 (divide by 0) handler */
  87     DWORD     int2 WINE_PACKED;           /* 36 int 2 (NMI) handler */
  88     DWORD     int4 WINE_PACKED;           /* 3a int 4 (INTO) handler */
  89     DWORD     int6 WINE_PACKED;           /* 3e int 6 (invalid opc) handler */
  90     DWORD     int7 WINE_PACKED;           /* 42 int 7 (coprocessor) handler */
  91     DWORD     int3e WINE_PACKED;          /* 46 int 3e (80x87 emu) handler */
  92     DWORD     int75 WINE_PACKED;          /* 4a int 75 (80x87 error) handler */
  93     DWORD     compat_flags WINE_PACKED;   /* 4e Compatibility flags */
  94     BYTE      unused4[2];                 /* 52 */
  95     struct _THDB   *thdb;                 /* 54 Pointer to thread database */
  96     struct _WSINFO *pwsi;                 /* 58 Socket control struct */
  97     BYTE      unused5[4];                 /* 5B */
  98     HANDLE16  hPDB;                       /* 60 Selector of PDB (i.e. PSP) */
  99     SEGPTR    dta WINE_PACKED;            /* 62 Current DTA */
 100     BYTE      curdrive;                   /* 66 Current drive */
 101     BYTE      curdir[65];                 /* 67 Current directory */
 102     WORD      nCmdShow;                   /* a8 cmdShow parameter to WinMain */
 103     HTASK16   hYieldTo;                   /* aa Next task to schedule */
 104     DWORD     dlls_to_init;               /* ac Ptr to DLLs to initialize */
 105     HANDLE16  hCSAlias;                   /* b0 Code segment for this TDB */
 106     THUNKS    thunks WINE_PACKED;         /* b2 Make proc instance thunks */
 107     WORD      more_thunks[6*4];           /* c2 Space for 6 more thunks */
 108     BYTE      module_name[8];             /* f2 Module name for task */
 109     WORD      magic;                      /* fa TDB signature */
 110     DWORD     unused7;                    /* fc */
 111     PDB       pdb;                        /* 100 PDB for this task */
 112 } TDB;
 113
 114 #define TDB_MAGIC    ('T' | ('D' << 8))
 115
 116   /* TDB flags */
 117 #define TDBF_WINOLDAP   0x0001
 118 #define TDBF_OS2APP     0x0008
 119 #define TDBF_WIN32      0x0010
 120
 121   /* USER signals */
 122 #define USIG_TERMINATION        0x0020
 123 #define USIG_DLL_LOAD           0x0040
 124 #define USIG_DLL_UNLOAD         0x0080
 125 #define USIG_GPF                0x0666
 126
 127
 128   /* THHOOK Kernel Data Structure */
 129 typedef struct _THHOOK
 130 {
 131     HANDLE16   hGlobalHeap;         /* 00 (handle BURGERMASTER) */
 132     WORD       pGlobalHeap;         /* 02 (selector BURGERMASTER) */
 133     HMODULE16  hExeHead;            /* 04 hFirstModule */
 134     HMODULE16  hExeSweep;           /* 06 (unused) */
 135     HANDLE16   TopPDB;              /* 08 (handle of KERNEL PDB) */
 136     HANDLE16   HeadPDB;             /* 0A (first PDB in list) */
 137     HANDLE16   TopSizePDB;          /* 0C (unused) */
 138     HTASK16    HeadTDB;             /* 0E hFirstTask */
 139     HTASK16    CurTDB;              /* 10 hCurrentTask */
 140     HTASK16    LoadTDB;             /* 12 (unused) */
 141     HTASK16    LockTDB;             /* 14 hLockedTask */
 142 } THHOOK;
 143
 144 #pragma pack(4)
 145
 146 extern THHOOK *pThhook;
 147 extern void (*TASK_AddTaskEntryBreakpoint)( HTASK16 hTask );
 148
 149 extern HTASK16 TASK_Create( struct _THDB *thdb, struct _NE_MODULE *pModule,
 150                             HINSTANCE16 hInstance, HINSTANCE16 hPrevInstance,
 151                             UINT16 cmdShow );
 152 extern void TASK_StartTask( HTASK16 hTask );
 153 extern void TASK_KillCurrentTask( INT16 exitCode );
 154 extern HTASK16 TASK_GetNextTask( HTASK16 hTask );
 155 extern BOOL32 TASK_Reschedule(void);
 156 extern void TASK_InstallTHHook( THHOOK *pNewThook );
 157
 158 extern HQUEUE16 WINAPI SetThreadQueue( DWORD thread, HQUEUE16 hQueue );
 159 extern HQUEUE16 WINAPI GetThreadQueue( DWORD thread );
 160 extern VOID WINAPI SetFastQueue( DWORD thread, HANDLE32 hQueue );
 161 extern HANDLE32 WINAPI GetFastQueue( void );
 162
 163
 164 #endif /* __WINE_TASK_H */