| [278] | 1 | /* $Id: HandleManager.h,v 1.4 1999-07-06 15:48:44 phaller Exp $ */ | 
|---|
| [262] | 2 |  | 
|---|
|  | 3 | /* | 
|---|
|  | 4 | * Project Odin Software License can be found in LICENSE.TXT | 
|---|
|  | 5 | * Win32 Unified Handle Manager for OS/2 | 
|---|
|  | 6 | * 1998/02/11 PH Patrick Haller (haller@zebra.fh-weingarten.de) | 
|---|
|  | 7 | * | 
|---|
|  | 8 | * @(#) HandleManager.Cpp       1.0.0   1998/02/11 PH start | 
|---|
|  | 9 | */ | 
|---|
|  | 10 |  | 
|---|
|  | 11 | #ifndef _HANDLEMANAGER_H_ | 
|---|
|  | 12 | #define _HANDLEMANAGER_H_ | 
|---|
|  | 13 |  | 
|---|
|  | 14 |  | 
|---|
|  | 15 | /***************************************************************************** | 
|---|
|  | 16 | * Remark                                                                    * | 
|---|
|  | 17 | ***************************************************************************** | 
|---|
|  | 18 |  | 
|---|
|  | 19 | 1998/02/11 PH The interface to the handle manager is twofold: | 
|---|
|  | 20 | a) HMxxx routines to be called from the "top" from the | 
|---|
|  | 21 | KERNEL32 stubs | 
|---|
|  | 22 | b) the HMDeviceHandler class is actually a workaround for | 
|---|
|  | 23 | the device driver that would handle the requests on Win32. | 
|---|
|  | 24 | To implement a new pseudo-device, one has create a new | 
|---|
|  | 25 | HMDeviceHandler class and link it into the table in the | 
|---|
|  | 26 | HANDLEMANAGER.CPP file. | 
|---|
|  | 27 | */ | 
|---|
|  | 28 |  | 
|---|
|  | 29 |  | 
|---|
|  | 30 | /***************************************************************************** | 
|---|
|  | 31 | * Includes                                                                  * | 
|---|
|  | 32 | *****************************************************************************/ | 
|---|
|  | 33 |  | 
|---|
|  | 34 | #ifdef _OS2WIN_H | 
|---|
|  | 35 | #include <winos2def.h> | 
|---|
|  | 36 | #else | 
|---|
|  | 37 | typedef struct { | 
|---|
|  | 38 | DWORD    Internal; | 
|---|
|  | 39 | DWORD    InternalHigh; | 
|---|
|  | 40 | DWORD    Offset; | 
|---|
|  | 41 | DWORD    OffsetHigh; | 
|---|
|  | 42 | HANDLE   hEvent; | 
|---|
|  | 43 | } OVERLAPPED, *POVERLAPPED, *LPOVERLAPPED; | 
|---|
|  | 44 | #endif | 
|---|
|  | 45 |  | 
|---|
|  | 46 |  | 
|---|
|  | 47 | /***************************************************************************** | 
|---|
|  | 48 | * Defines & Macros                                                          * | 
|---|
|  | 49 | *****************************************************************************/ | 
|---|
|  | 50 |  | 
|---|
|  | 51 | /* 1998/02/12 PH Correction of os2win.h */ | 
|---|
|  | 52 | #undef FILE_TYPE_UNKNOWN | 
|---|
|  | 53 | #define FILE_TYPE_UNKNOWN   0x0000 | 
|---|
|  | 54 |  | 
|---|
|  | 55 | #undef FILE_TYPE_DISK | 
|---|
|  | 56 | #define FILE_TYPE_DISK      0x0001 | 
|---|
|  | 57 |  | 
|---|
|  | 58 | #undef FILE_TYPE_CHAR | 
|---|
|  | 59 | #define FILE_TYPE_CHAR      0x0002 | 
|---|
|  | 60 |  | 
|---|
|  | 61 | #undef FILE_TYPE_PIPE | 
|---|
|  | 62 | #define FILE_TYPE_PIPE      0x0003 | 
|---|
|  | 63 |  | 
|---|
|  | 64 | #undef FILE_TYPE_REMOTE | 
|---|
|  | 65 | #define FILE_TYPE_REMOTE    0x8000 | 
|---|
|  | 66 |  | 
|---|
|  | 67 | #ifndef INVALID_HANDLE_ERROR | 
|---|
|  | 68 | #define INVALID_HANDLE_ERROR (-1) | 
|---|
|  | 69 | #endif | 
|---|
|  | 70 |  | 
|---|
|  | 71 |  | 
|---|
|  | 72 | /***************************************************************************** | 
|---|
|  | 73 | * Structures                                                                * | 
|---|
|  | 74 | *****************************************************************************/ | 
|---|
|  | 75 |  | 
|---|
|  | 76 |  | 
|---|
|  | 77 | /***************************************************************************** | 
|---|
|  | 78 | * Prototypes                                                                * | 
|---|
|  | 79 | *****************************************************************************/ | 
|---|
|  | 80 |  | 
|---|
|  | 81 | DWORD  HMInitialize(void);          /* initialize the HandleManager */ | 
|---|
|  | 82 |  | 
|---|
|  | 83 | DWORD  HMTerminate(void);            /* terminate the HandleManager */ | 
|---|
|  | 84 |  | 
|---|
|  | 85 |  | 
|---|
|  | 86 | /* handle manager version of GetStdHandle, Open32 can't really help us here */ | 
|---|
|  | 87 | HANDLE  HMGetStdHandle(DWORD nStdHandle); | 
|---|
|  | 88 |  | 
|---|
|  | 89 | /* handle manager version of GetStdHandle, Open32 can't really help us here */ | 
|---|
|  | 90 | BOOL    HMSetStdHandle(DWORD  nStdHandle, | 
|---|
|  | 91 | HANDLE hHandle); | 
|---|
|  | 92 |  | 
|---|
|  | 93 |  | 
|---|
|  | 94 | /*****************************************************************************/ | 
|---|
|  | 95 | /* handle translation buffer management                                      */ | 
|---|
|  | 96 | /*                                                                           */ | 
|---|
|  | 97 | /* Since some Win32 applications rely (!) on 16-bit handles, we've got to do */ | 
|---|
|  | 98 | /* 32-bit to 16-bit and vs vsa translation here.                             */ | 
|---|
|  | 99 | /* Filehandle-based functions should be routed via the handlemanager instead */ | 
|---|
|  | 100 | /* of going to Open32 directly.                                              */ | 
|---|
|  | 101 | /*****************************************************************************/ | 
|---|
|  | 102 |  | 
|---|
|  | 103 | DWORD  HMHandleAllocate       (PULONG phHandle16, | 
|---|
|  | 104 | ULONG  hHandle32); | 
|---|
|  | 105 |  | 
|---|
|  | 106 | DWORD  HMHandleFree           (ULONG  hHandle16); | 
|---|
|  | 107 |  | 
|---|
|  | 108 | DWORD  HMHandleValidate       (ULONG  hHandle16); | 
|---|
|  | 109 |  | 
|---|
|  | 110 | DWORD  HMHandleTranslateToWin (ULONG  hHandle32, | 
|---|
|  | 111 | PULONG phHandle16); | 
|---|
|  | 112 |  | 
|---|
|  | 113 | DWORD  HMHandleTranslateToOS2 (ULONG  hHandle16, | 
|---|
|  | 114 | PULONG hHandle32); | 
|---|
|  | 115 |  | 
|---|
|  | 116 | DWORD  HMHandleTranslateToOS2i(ULONG  hHandle16); | 
|---|
|  | 117 |  | 
|---|
|  | 118 |  | 
|---|
|  | 119 | /***************************************************************************** | 
|---|
|  | 120 | * Forwarders                                                                * | 
|---|
|  | 121 | *****************************************************************************/ | 
|---|
|  | 122 |  | 
|---|
|  | 123 | // enable C linkage to avoid parameter mangling | 
|---|
|  | 124 | #ifdef __cplusplus__ | 
|---|
|  | 125 | extern "C" { | 
|---|
|  | 126 | #endif | 
|---|
|  | 127 |  | 
|---|
| [278] | 128 | HANDLE HMCreateEvent                (LPSECURITY_ATTRIBUTES      lpsa, | 
|---|
|  | 129 | BOOL                       bManualReset, | 
|---|
|  | 130 | BOOL                       bInitialState, | 
|---|
|  | 131 | LPCSTR                     lpName); | 
|---|
| [262] | 132 |  | 
|---|
| [278] | 133 | HANDLE HMCreateMutex                (LPSECURITY_ATTRIBUTES      lpsa, | 
|---|
|  | 134 | BOOL                       bInitialOwner, | 
|---|
|  | 135 | LPCSTR                     lpName); | 
|---|
| [262] | 136 |  | 
|---|
| [278] | 137 | HANDLE HMCreateFile                 (LPCSTR                     lpFileName, | 
|---|
|  | 138 | DWORD                      dwDesiredAccess, | 
|---|
|  | 139 | DWORD                      dwShareMode, | 
|---|
|  | 140 | LPSECURITY_ATTRIBUTES      lpSecurityAttributes, | 
|---|
|  | 141 | DWORD                      dwCreationDisposition, | 
|---|
|  | 142 | DWORD                      dwFlagsAndAttributes, | 
|---|
|  | 143 | HANDLE                     hTemplateFile); | 
|---|
| [262] | 144 |  | 
|---|
| [278] | 145 | HANDLE HMOpenFile                   (LPCSTR                     lpFileName, | 
|---|
|  | 146 | OFSTRUCT*                  pOFStruct, | 
|---|
|  | 147 | UINT                       fuMode); | 
|---|
| [262] | 148 |  | 
|---|
| [278] | 149 | HANDLE HMOpenEvent                  (DWORD                      fdwAccess, | 
|---|
|  | 150 | BOOL                       fInherit, | 
|---|
|  | 151 | LPCSTR                     lpName); | 
|---|
| [262] | 152 |  | 
|---|
| [278] | 153 | HANDLE HMOpenMutex                  (DWORD                      fdwAccess, | 
|---|
|  | 154 | BOOL                       fInherit, | 
|---|
|  | 155 | LPCSTR                    lpName); | 
|---|
| [262] | 156 |  | 
|---|
| [278] | 157 | BOOL   HMCloseHandle                (HANDLE                     hObject); | 
|---|
| [262] | 158 |  | 
|---|
| [278] | 159 | BOOL   HMReadFile                   (HANDLE                     hFile, | 
|---|
|  | 160 | LPVOID                     lpBuffer, | 
|---|
|  | 161 | DWORD                      nNumberOfBytesToRead, | 
|---|
|  | 162 | LPDWORD                    lpNumberOfBytesRead, | 
|---|
|  | 163 | LPOVERLAPPED               lpOverlapped); | 
|---|
| [262] | 164 |  | 
|---|
| [278] | 165 | BOOL   HMWriteFile                  (HANDLE                     hFile, | 
|---|
|  | 166 | LPCVOID                    lpBuffer, | 
|---|
|  | 167 | DWORD                      nNumberOfBytesToWrite, | 
|---|
|  | 168 | LPDWORD                    lpNumberOfBytesWritten, | 
|---|
|  | 169 | LPOVERLAPPED               lpOverlapped); | 
|---|
| [262] | 170 |  | 
|---|
| [278] | 171 | DWORD  HMGetFileType                (HANDLE                     hFile); | 
|---|
| [262] | 172 |  | 
|---|
| [278] | 173 | DWORD  HMDeviceRequest              (HANDLE                     hFile, | 
|---|
|  | 174 | ULONG                      ulRequestCode, | 
|---|
|  | 175 | ULONG                      arg1, | 
|---|
|  | 176 | ULONG                      arg2, | 
|---|
|  | 177 | ULONG                      arg3, | 
|---|
|  | 178 | ULONG                      arg4); | 
|---|
| [262] | 179 |  | 
|---|
| [278] | 180 | BOOL   HMGetFileInformationByHandle (HANDLE                     hFile, | 
|---|
|  | 181 | BY_HANDLE_FILE_INFORMATION *pHFI); | 
|---|
| [262] | 182 |  | 
|---|
| [278] | 183 | BOOL   HMSetEndOfFile               (HANDLE                     hFile); | 
|---|
| [262] | 184 |  | 
|---|
| [278] | 185 | BOOL   HMSetFileTime                (HANDLE                     hFile, | 
|---|
|  | 186 | const FILETIME             *pFT1, | 
|---|
|  | 187 | const FILETIME             *pFT2, | 
|---|
|  | 188 | const FILETIME             *pFT3); | 
|---|
| [262] | 189 |  | 
|---|
| [278] | 190 | DWORD  HMGetFileSize                (HANDLE                     hFile, | 
|---|
|  | 191 | PDWORD                     pSize); | 
|---|
| [262] | 192 |  | 
|---|
| [278] | 193 | DWORD  HMSetFilePointer             (HANDLE                     hFile, | 
|---|
|  | 194 | LONG                       lDistanceToMove, | 
|---|
|  | 195 | PLONG                      lpDistanceToMoveHigh, | 
|---|
|  | 196 | DWORD                      dwMoveMethod); | 
|---|
| [262] | 197 |  | 
|---|
| [278] | 198 | BOOL   HMLockFile                   (HFILE                      hFile, | 
|---|
|  | 199 | DWORD                      dwFileOffsetLow, | 
|---|
|  | 200 | DWORD                      dwFileOffsetHigh, | 
|---|
|  | 201 | DWORD                      nNumberOfBytesToLockLow, | 
|---|
|  | 202 | DWORD                      nNumberOfBytesToLockHigh); | 
|---|
| [262] | 203 |  | 
|---|
| [278] | 204 | BOOL   HMLockFileEx                 (HANDLE                     hFile, | 
|---|
|  | 205 | DWORD                      dwFlags, | 
|---|
|  | 206 | DWORD                      dwReserved, | 
|---|
|  | 207 | DWORD                      nNumberOfBytesToLockLow, | 
|---|
|  | 208 | DWORD                      nNumberOfBytesToLockHigh, | 
|---|
|  | 209 | LPOVERLAPPED               lpOverlapped); | 
|---|
|  | 210 |  | 
|---|
|  | 211 | BOOL   HMUnlockFile                 (HANDLE                     hFile, | 
|---|
|  | 212 | DWORD                      dwFileOffsetLow, | 
|---|
|  | 213 | DWORD                      dwFileOffsetHigh, | 
|---|
|  | 214 | DWORD                      cbUnlockLow, | 
|---|
|  | 215 | DWORD                      cbUnlockHigh); | 
|---|
|  | 216 |  | 
|---|
|  | 217 | BOOL   HMUnlockFileEx               (HANDLE                     hFile, | 
|---|
|  | 218 | DWORD                      dwFlags, | 
|---|
|  | 219 | DWORD                      dwReserved, | 
|---|
|  | 220 | DWORD                      nNumberOfBytesToLockLow, | 
|---|
|  | 221 | DWORD                      nNumberOfBytesToLockHigh, | 
|---|
|  | 222 | LPOVERLAPPED               lpOverlapped); | 
|---|
|  | 223 |  | 
|---|
|  | 224 | DWORD  HMWaitForSingleObject        (HANDLE                     hObject, | 
|---|
|  | 225 | DWORD                      dwTimeout); | 
|---|
|  | 226 |  | 
|---|
|  | 227 | DWORD  HMWaitForSingleObjectEx      (HANDLE                     hObject, | 
|---|
|  | 228 | DWORD                      dwTimeout, | 
|---|
|  | 229 | BOOL                       fAlertable); | 
|---|
|  | 230 |  | 
|---|
|  | 231 | DWORD  HMWaitForMultipleObjects     (DWORD                      cObjects, | 
|---|
|  | 232 | HANDLE                    *lphObjects, | 
|---|
|  | 233 | BOOL                       fWaitAll, | 
|---|
|  | 234 | DWORD                      dwTimeout); | 
|---|
|  | 235 |  | 
|---|
|  | 236 | DWORD  HMWaitForMultipleObjectsEx   (DWORD                      cObjects, | 
|---|
|  | 237 | HANDLE                    *lphObjects, | 
|---|
|  | 238 | BOOL                       fWaitAll, | 
|---|
|  | 239 | DWORD                      dwTimeout, | 
|---|
|  | 240 | BOOL                       fAlertable); | 
|---|
|  | 241 |  | 
|---|
|  | 242 | BOOL   HMFlushFileBuffers           (HANDLE                     hObject); | 
|---|
|  | 243 |  | 
|---|
|  | 244 | BOOL   HMGetOverlappedResult        (HANDLE                     hObject, | 
|---|
|  | 245 | LPOVERLAPPED               lpOverlapped, | 
|---|
|  | 246 | LPDWORD                    lpNumberOfBytesTransferred, | 
|---|
|  | 247 | BOOL                       bWait); | 
|---|
|  | 248 |  | 
|---|
|  | 249 | BOOL   HMReleaseMutex               (HANDLE                     hObject); | 
|---|
|  | 250 |  | 
|---|
|  | 251 | BOOL   HMSetEvent                   (HANDLE                     hEvent); | 
|---|
|  | 252 |  | 
|---|
|  | 253 | BOOL   HMPulseEvent                 (HANDLE                     hEvent); | 
|---|
|  | 254 |  | 
|---|
|  | 255 | BOOL   HMResetEvent                 (HANDLE                     hEvent); | 
|---|
|  | 256 |  | 
|---|
|  | 257 | HANDLE HMCreateSemaphore            (LPSECURITY_ATTRIBUTES      lpsa, | 
|---|
|  | 258 | LONG                       lInitialCount, | 
|---|
|  | 259 | LONG                       lMaximumCount, | 
|---|
|  | 260 | LPCSTR                     lpszSemaphoreName); | 
|---|
|  | 261 |  | 
|---|
|  | 262 | HANDLE HMOpenSemaphore              (DWORD                      fdwAccess, | 
|---|
|  | 263 | BOOL                       fInheritHandle, | 
|---|
|  | 264 | LPCSTR                     lpszSemaphoreName); | 
|---|
|  | 265 |  | 
|---|
|  | 266 | BOOL   HMReleaseSemaphore           (HANDLE                     hSemaphore, | 
|---|
|  | 267 | LONG                       cReleaseCount, | 
|---|
|  | 268 | LPLONG                     lpPreviousCount); | 
|---|
|  | 269 |  | 
|---|
|  | 270 |  | 
|---|
| [262] | 271 | #ifdef __cplusplus__ | 
|---|
|  | 272 | } | 
|---|
|  | 273 | #endif | 
|---|
|  | 274 |  | 
|---|
|  | 275 | #endif /* _HANDLEMANAGER_H_ */ | 
|---|