| 1 | /** | 
 
 
 
 
 | 2 | * This file is part of the mingw-w64 runtime package. | 
 
 
 
 
 | 3 | * No warranty is given; refer to the file DISCLAIMER within this package. | 
 
 
 
 
 | 4 | */ | 
 
 
 
 
 | 5 | /* | 
 
 
 
 
 | 6 | * evntprov.h | 
 
 
 
 
 | 7 | * | 
 
 
 
 
 | 8 | * This file is part of the ReactOS PSDK package. | 
 
 
 
 
 | 9 | * | 
 
 
 
 
 | 10 | * Contributors: | 
 
 
 
 
 | 11 | *   Created by Amine Khaldi. | 
 
 
 
 
 | 12 | *   Extended by Kai Tietz for mingw-w64 | 
 
 
 
 
 | 13 | * | 
 
 
 
 
 | 14 | * THIS SOFTWARE IS NOT COPYRIGHTED | 
 
 
 
 
 | 15 | * | 
 
 
 
 
 | 16 | * This source code is offered for use in the public domain. You may | 
 
 
 
 
 | 17 | * use, modify or distribute it freely. | 
 
 
 
 
 | 18 | * | 
 
 
 
 
 | 19 | * This code is distributed in the hope that it will be useful but | 
 
 
 
 
 | 20 | * WITHOUT ANY WARRANTY. ALL WARRANTIES, EXPRESS OR IMPLIED ARE HEREBY | 
 
 
 
 
 | 21 | * DISCLAIMED. This includes but is not limited to warranties of | 
 
 
 
 
 | 22 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. | 
 
 
 
 
 | 23 | * | 
 
 
 
 
 | 24 | */ | 
 
 
 
 
 | 25 |  | 
 
 
 
 
 | 26 | #ifndef _EVNTPROV_H_ | 
 
 
 
 
 | 27 | #define _EVNTPROV_H_ | 
 
 
 
 
 | 28 |  | 
 
 
 
 
 | 29 | #include <winapifamily.h> | 
 
 
 
 
 | 30 |  | 
 
 
 
 
 | 31 | #if !defined (EVNTAPI) && !defined (__WIDL__) && !defined (MIDL_PASS) | 
 
 
 
 
 | 32 | #ifdef _EVNT_SOURCE_ | 
 
 
 
 
 | 33 | #ifdef _ARM_ | 
 
 
 
 
 | 34 | #define EVNTAPI | 
 
 
 
 
 | 35 | #else | 
 
 
 
 
 | 36 | #define EVNTAPI __stdcall | 
 
 
 
 
 | 37 | #endif | 
 
 
 
 
 | 38 | #else | 
 
 
 
 
 | 39 | #ifdef _ARM_ | 
 
 
 
 
 | 40 | #define EVNTAPI DECLSPEC_IMPORT | 
 
 
 
 
 | 41 | #else | 
 
 
 
 
 | 42 | #define EVNTAPI DECLSPEC_IMPORT __stdcall | 
 
 
 
 
 | 43 | #endif | 
 
 
 
 
 | 44 | #endif | 
 
 
 
 
 | 45 | #endif | 
 
 
 
 
 | 46 |  | 
 
 
 
 
 | 47 | #define EVENT_MIN_LEVEL (0) | 
 
 
 
 
 | 48 | #define EVENT_MAX_LEVEL (0xff) | 
 
 
 
 
 | 49 |  | 
 
 
 
 
 | 50 | #define EVENT_ACTIVITY_CTRL_GET_ID (1) | 
 
 
 
 
 | 51 | #define EVENT_ACTIVITY_CTRL_SET_ID (2) | 
 
 
 
 
 | 52 | #define EVENT_ACTIVITY_CTRL_CREATE_ID (3) | 
 
 
 
 
 | 53 | #define EVENT_ACTIVITY_CTRL_GET_SET_ID (4) | 
 
 
 
 
 | 54 | #define EVENT_ACTIVITY_CTRL_CREATE_SET_ID (5) | 
 
 
 
 
 | 55 |  | 
 
 
 
 
 | 56 | #define EVENT_FILTER_TYPE_SCHEMATIZED (0x80000000) | 
 
 
 
 
 | 57 | #define EVENT_FILTER_TYPE_SYSTEM_FLAGS (0x80000001) | 
 
 
 
 
 | 58 | #define EVENT_FILTER_TYPE_TRACEHANDLE (0x80000002) | 
 
 
 
 
 | 59 |  | 
 
 
 
 
 | 60 | #define MAX_EVENT_DATA_DESCRIPTORS (128) | 
 
 
 
 
 | 61 | #define MAX_EVENT_FILTER_DATA_SIZE (1024) | 
 
 
 
 
 | 62 |  | 
 
 
 
 
 | 63 | #ifdef __cplusplus | 
 
 
 
 
 | 64 | extern "C" { | 
 
 
 
 
 | 65 | #endif | 
 
 
 
 
 | 66 |  | 
 
 
 
 
 | 67 | #include <guiddef.h> | 
 
 
 
 
 | 68 |  | 
 
 
 
 
 | 69 | typedef ULONGLONG REGHANDLE,*PREGHANDLE; | 
 
 
 
 
 | 70 |  | 
 
 
 
 
 | 71 | typedef struct _EVENT_DATA_DESCRIPTOR { | 
 
 
 
 
 | 72 | ULONGLONG Ptr; | 
 
 
 
 
 | 73 | ULONG Size; | 
 
 
 
 
 | 74 | ULONG Reserved; | 
 
 
 
 
 | 75 | } EVENT_DATA_DESCRIPTOR,*PEVENT_DATA_DESCRIPTOR; | 
 
 
 
 
 | 76 |  | 
 
 
 
 
 | 77 | #ifndef EVENT_DESCRIPTOR_DEF | 
 
 
 
 
 | 78 | #define EVENT_DESCRIPTOR_DEF | 
 
 
 
 
 | 79 | typedef struct _EVENT_DESCRIPTOR { | 
 
 
 
 
 | 80 | USHORT Id; | 
 
 
 
 
 | 81 | UCHAR Version; | 
 
 
 
 
 | 82 | UCHAR Channel; | 
 
 
 
 
 | 83 | UCHAR Level; | 
 
 
 
 
 | 84 | UCHAR Opcode; | 
 
 
 
 
 | 85 | USHORT Task; | 
 
 
 
 
 | 86 | ULONGLONG Keyword; | 
 
 
 
 
 | 87 | } EVENT_DESCRIPTOR,*PEVENT_DESCRIPTOR; | 
 
 
 
 
 | 88 | typedef const EVENT_DESCRIPTOR *PCEVENT_DESCRIPTOR; | 
 
 
 
 
 | 89 | #endif | 
 
 
 
 
 | 90 |  | 
 
 
 
 
 | 91 | struct _EVENT_FILTER_DESCRIPTOR { | 
 
 
 
 
 | 92 | ULONGLONG Ptr; | 
 
 
 
 
 | 93 | ULONG Size; | 
 
 
 
 
 | 94 | ULONG Type; | 
 
 
 
 
 | 95 | }; | 
 
 
 
 
 | 96 |  | 
 
 
 
 
 | 97 | #ifndef DEFINED_PEVENT_FILTER_DESC | 
 
 
 
 
 | 98 | #define DEFINED_PEVENT_FILTER_DESC | 
 
 
 
 
 | 99 | typedef struct _EVENT_FILTER_DESCRIPTOR EVENT_FILTER_DESCRIPTOR,*PEVENT_FILTER_DESCRIPTOR; | 
 
 
 
 
 | 100 | #endif /* for evntrace.h */ | 
 
 
 
 
 | 101 |  | 
 
 
 
 
 | 102 | typedef struct _EVENT_FILTER_HEADER { | 
 
 
 
 
 | 103 | USHORT Id; | 
 
 
 
 
 | 104 | UCHAR Version; | 
 
 
 
 
 | 105 | UCHAR Reserved[5]; | 
 
 
 
 
 | 106 | ULONGLONG InstanceId; | 
 
 
 
 
 | 107 | ULONG Size; | 
 
 
 
 
 | 108 | ULONG NextOffset; | 
 
 
 
 
 | 109 | } EVENT_FILTER_HEADER,*PEVENT_FILTER_HEADER; | 
 
 
 
 
 | 110 |  | 
 
 
 
 
 | 111 | #if !defined (_ETW_KM_) && !defined (__WIDL__)  /* for wdm.h & widl */ | 
 
 
 
 
 | 112 | typedef enum _EVENT_INFO_CLASS { | 
 
 
 
 
 | 113 | EventProviderBinaryTrackInfo, | 
 
 
 
 
 | 114 | MaxEventInfo | 
 
 
 
 
 | 115 | } EVENT_INFO_CLASS; | 
 
 
 
 
 | 116 |  | 
 
 
 
 
 | 117 | typedef VOID (NTAPI *PENABLECALLBACK) (LPCGUID SourceId, ULONG IsEnabled, UCHAR Level, ULONGLONG MatchAnyKeyword, ULONGLONG MatchAllKeyword, PEVENT_FILTER_DESCRIPTOR FilterData, PVOID CallbackContext); | 
 
 
 
 
 | 118 |  | 
 
 
 
 
 | 119 | #if WINAPI_FAMILY_PARTITION (WINAPI_PARTITION_DESKTOP) | 
 
 
 
 
 | 120 | #if WINVER >= 0x0600 | 
 
 
 
 
 | 121 | BOOLEAN EVNTAPI EventEnabled (REGHANDLE RegHandle, PCEVENT_DESCRIPTOR EventDescriptor); | 
 
 
 
 
 | 122 | BOOLEAN EVNTAPI EventProviderEnabled (REGHANDLE RegHandle, UCHAR Level, ULONGLONG Keyword); | 
 
 
 
 
 | 123 | ULONG EVNTAPI EventWriteTransfer (REGHANDLE RegHandle, PCEVENT_DESCRIPTOR EventDescriptor, LPCGUID ActivityId, LPCGUID RelatedActivityId, ULONG UserDataCount, PEVENT_DATA_DESCRIPTOR UserData); | 
 
 
 
 
 | 124 | ULONG EVNTAPI EventWriteString (REGHANDLE RegHandle, UCHAR Level, ULONGLONG Keyword, PCWSTR String); | 
 
 
 
 
 | 125 | ULONG EVNTAPI EventActivityIdControl (ULONG ControlCode, LPGUID ActivityId); | 
 
 
 
 
 | 126 | #endif | 
 
 
 
 
 | 127 | #if WINVER >= 0x0601 | 
 
 
 
 
 | 128 | ULONG EVNTAPI EventWriteEx (REGHANDLE RegHandle, PCEVENT_DESCRIPTOR EventDescriptor, ULONG64 Filter, ULONG Flags, LPCGUID ActivityId, LPCGUID RelatedActivityId, ULONG UserDataCount, PEVENT_DATA_DESCRIPTOR UserData); | 
 
 
 
 
 | 129 | #endif | 
 
 
 
 
 | 130 | #endif | 
 
 
 
 
 | 131 |  | 
 
 
 
 
 | 132 | #if WINAPI_FAMILY_PARTITION (WINAPI_PARTITION_APP) | 
 
 
 
 
 | 133 | #if WINVER >= 0x0600 | 
 
 
 
 
 | 134 | ULONG EVNTAPI EventRegister (LPCGUID ProviderId, PENABLECALLBACK EnableCallback, PVOID CallbackContext, PREGHANDLE RegHandle); | 
 
 
 
 
 | 135 | ULONG EVNTAPI EventUnregister (REGHANDLE RegHandle); | 
 
 
 
 
 | 136 | ULONG EVNTAPI EventWrite (REGHANDLE RegHandle, PCEVENT_DESCRIPTOR EventDescriptor, ULONG UserDataCount, PEVENT_DATA_DESCRIPTOR UserData); | 
 
 
 
 
 | 137 | #endif | 
 
 
 
 
 | 138 | #if WINVER >= 0x0602 | 
 
 
 
 
 | 139 | ULONG EVNTAPI EventSetInformation (REGHANDLE RegHandle, EVENT_INFO_CLASS InformationClass, PVOID EventInformation, ULONG InformationLength); | 
 
 
 
 
 | 140 | #endif | 
 
 
 
 
 | 141 | #endif | 
 
 
 
 
 | 142 |  | 
 
 
 
 
 | 143 | #endif | 
 
 
 
 
 | 144 |  | 
 
 
 
 
 | 145 | #if WINAPI_FAMILY_PARTITION (WINAPI_PARTITION_APP) | 
 
 
 
 
 | 146 | FORCEINLINE VOID EventDataDescCreate (PEVENT_DATA_DESCRIPTOR evp, const VOID *d, ULONG sz) { | 
 
 
 
 
 | 147 | evp->Ptr = (ULONGLONG) (ULONG_PTR) d; | 
 
 
 
 
 | 148 | evp->Size = sz; | 
 
 
 
 
 | 149 | evp->Reserved = 0; | 
 
 
 
 
 | 150 | } | 
 
 
 
 
 | 151 | #endif | 
 
 
 
 
 | 152 |  | 
 
 
 
 
 | 153 | #if WINAPI_FAMILY_PARTITION (WINAPI_PARTITION_DESKTOP) | 
 
 
 
 
 | 154 | FORCEINLINE VOID EventDescCreate (PEVENT_DESCRIPTOR ev, USHORT Id, UCHAR ver, UCHAR ch, UCHAR lvl, USHORT t, UCHAR opc, ULONGLONG keyw) { | 
 
 
 
 
 | 155 | ev->Id = Id; | 
 
 
 
 
 | 156 | ev->Version = ver; | 
 
 
 
 
 | 157 | ev->Channel = ch; | 
 
 
 
 
 | 158 | ev->Level = lvl; | 
 
 
 
 
 | 159 | ev->Task = t; | 
 
 
 
 
 | 160 | ev->Opcode = opc; | 
 
 
 
 
 | 161 | ev->Keyword = keyw; | 
 
 
 
 
 | 162 | } | 
 
 
 
 
 | 163 |  | 
 
 
 
 
 | 164 | FORCEINLINE UCHAR EventDescGetChannel (PCEVENT_DESCRIPTOR ev) { | 
 
 
 
 
 | 165 | return ev->Channel; | 
 
 
 
 
 | 166 | } | 
 
 
 
 
 | 167 |  | 
 
 
 
 
 | 168 | FORCEINLINE USHORT EventDescGetId (PCEVENT_DESCRIPTOR ev) { | 
 
 
 
 
 | 169 | return ev->Id; | 
 
 
 
 
 | 170 | } | 
 
 
 
 
 | 171 |  | 
 
 
 
 
 | 172 | FORCEINLINE ULONGLONG EventDescGetKeyword (PCEVENT_DESCRIPTOR ev) { | 
 
 
 
 
 | 173 | return ev->Keyword; | 
 
 
 
 
 | 174 | } | 
 
 
 
 
 | 175 |  | 
 
 
 
 
 | 176 | FORCEINLINE UCHAR EventDescGetLevel (PCEVENT_DESCRIPTOR ev) { | 
 
 
 
 
 | 177 | return ev->Level; | 
 
 
 
 
 | 178 | } | 
 
 
 
 
 | 179 |  | 
 
 
 
 
 | 180 | FORCEINLINE UCHAR EventDescGetOpcode (PCEVENT_DESCRIPTOR ev) { | 
 
 
 
 
 | 181 | return ev->Opcode; | 
 
 
 
 
 | 182 | } | 
 
 
 
 
 | 183 |  | 
 
 
 
 
 | 184 | FORCEINLINE USHORT EventDescGetTask (PCEVENT_DESCRIPTOR ev) { | 
 
 
 
 
 | 185 | return ev->Task; | 
 
 
 
 
 | 186 | } | 
 
 
 
 
 | 187 |  | 
 
 
 
 
 | 188 | FORCEINLINE PEVENT_DESCRIPTOR EventDescOrKeyword (PEVENT_DESCRIPTOR ev, ULONGLONG keyw) { | 
 
 
 
 
 | 189 | ev->Keyword |= keyw; | 
 
 
 
 
 | 190 | return ev; | 
 
 
 
 
 | 191 | } | 
 
 
 
 
 | 192 |  | 
 
 
 
 
 | 193 | FORCEINLINE UCHAR EventDescGetVersion (PCEVENT_DESCRIPTOR ev) { | 
 
 
 
 
 | 194 | return ev->Version; | 
 
 
 
 
 | 195 | } | 
 
 
 
 
 | 196 |  | 
 
 
 
 
 | 197 | FORCEINLINE PEVENT_DESCRIPTOR EventDescSetChannel (PEVENT_DESCRIPTOR ev, UCHAR ch) { | 
 
 
 
 
 | 198 | ev->Channel = ch; | 
 
 
 
 
 | 199 | return ev; | 
 
 
 
 
 | 200 | } | 
 
 
 
 
 | 201 |  | 
 
 
 
 
 | 202 | FORCEINLINE PEVENT_DESCRIPTOR EventDescSetId (PEVENT_DESCRIPTOR ev, USHORT Id) { | 
 
 
 
 
 | 203 | ev->Id = Id; | 
 
 
 
 
 | 204 | return ev; | 
 
 
 
 
 | 205 | } | 
 
 
 
 
 | 206 |  | 
 
 
 
 
 | 207 | FORCEINLINE PEVENT_DESCRIPTOR EventDescSetKeyword (PEVENT_DESCRIPTOR ev, ULONGLONG keyw) { | 
 
 
 
 
 | 208 | ev->Keyword = keyw; | 
 
 
 
 
 | 209 | return ev; | 
 
 
 
 
 | 210 | } | 
 
 
 
 
 | 211 |  | 
 
 
 
 
 | 212 | FORCEINLINE PEVENT_DESCRIPTOR EventDescSetLevel (PEVENT_DESCRIPTOR ev, UCHAR lvl) { | 
 
 
 
 
 | 213 | ev->Level = lvl; | 
 
 
 
 
 | 214 | return ev; | 
 
 
 
 
 | 215 | } | 
 
 
 
 
 | 216 |  | 
 
 
 
 
 | 217 | FORCEINLINE PEVENT_DESCRIPTOR EventDescSetOpcode (PEVENT_DESCRIPTOR ev, UCHAR opc) { | 
 
 
 
 
 | 218 | ev->Opcode = opc; | 
 
 
 
 
 | 219 | return ev; | 
 
 
 
 
 | 220 | } | 
 
 
 
 
 | 221 |  | 
 
 
 
 
 | 222 | FORCEINLINE PEVENT_DESCRIPTOR EventDescSetTask (PEVENT_DESCRIPTOR ev, USHORT t) { | 
 
 
 
 
 | 223 | ev->Task = t; | 
 
 
 
 
 | 224 | return ev; | 
 
 
 
 
 | 225 | } | 
 
 
 
 
 | 226 |  | 
 
 
 
 
 | 227 | FORCEINLINE PEVENT_DESCRIPTOR EventDescSetVersion (PEVENT_DESCRIPTOR ev, UCHAR ver) { | 
 
 
 
 
 | 228 | ev->Version = ver; | 
 
 
 
 
 | 229 | return ev; | 
 
 
 
 
 | 230 | } | 
 
 
 
 
 | 231 |  | 
 
 
 
 
 | 232 | FORCEINLINE VOID EventDescZero (PEVENT_DESCRIPTOR ev) { | 
 
 
 
 
 | 233 | memset (ev, 0, sizeof (EVENT_DESCRIPTOR)); | 
 
 
 
 
 | 234 | } | 
 
 
 
 
 | 235 | #endif | 
 
 
 
 
 | 236 |  | 
 
 
 
 
 | 237 | #ifdef __cplusplus | 
 
 
 
 
 | 238 | } | 
 
 
 
 
 | 239 | #endif | 
 
 
 
 
 | 240 |  | 
 
 
 
 
 | 241 | #endif |