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 typedef 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 242
