EVENT_INFO_CLASS列舉 (evntprov.h)
EVENT_INFO_CLASS列舉類型會與EventSetInformation函式搭配使用,以指定要在 ETW 事件提供者註冊上執行的組態作業。
Syntax
typedef enum _EVENT_INFO_CLASS {
EventProviderBinaryTrackInfo,
EventProviderSetReserved1,
EventProviderSetTraits,
EventProviderUseDescriptorType,
MaxEventInfo
} EVENT_INFO_CLASS;
常數
EventProviderBinaryTrackInfo 將這個提供者的二進位追蹤資訊新增至每個會話 從這個事件提供者收集事件。 二進位追蹤資料包括 包含指定之回呼的二進位檔完整路徑 註冊事件提供者。 如果二進位檔,這項資訊很有用 包含 -generated mc.exe 解碼資源,但未全域註冊。 解碼工具可以使用 在追蹤中尋找二進位檔並擷取解碼資源的路徑。 EventInformation緩衝區不會與此組態作業搭配使用。 此 ETW 執行時間會自動使用呼叫端模組的完整路徑, ( DLL 或 EXE 的完整路徑,其中包含 中指定的回呼函式 呼叫 EventRegister) 。 若要讓此作業很有用,請使用相同的 DLL 或 EXE 檔案必須包含 mc.exe 產生的解碼資源。 |
EventProviderSetReserved1 未使用。 |
EventProviderSetTraits 設定提供者的特性,例如提供者的名稱。 指出 ETW 應該辨識 Type 的欄位使用的EVENT_DATA_DESCRIPTOR 結構 使用此提供者。 需要提供者初始化 的所有欄位 EVENT_DATA_DESCRIPTOR 結構,包括 Reserved 欄位。 (提供者通常應該設定 dataDescriptor.Reserved = 0 ,如同 所完成EventDataDescCreate.) 請注意, EVENT_DATA_DESCRIPTOR 結構包含 Type 中的欄位結構 Reserved 先前為 欄位的 區段。 若要避免保留字段未初始化的提供者相容性問題 除非提供者已使用,否則 ETW 會忽略 Type 欄位 (將其視為 0) 呼叫中的 EventProviderSetTraits或EventProviderUseDescriptorType EventSetInformation。 EventInformation緩衝區應該包含 要用於 的提供者特性 提供者版本,以執行快速檢查。 |
EventProviderUseDescriptorType 指定 ETW 是否應該辨識 Type 的欄位使用的EVENT_DATA_DESCRIPTOR 結構 使用此提供者。 如果 TRUE 為 ,則要求提供者初始化 的所有欄位EVENT_DATA_DESCRIPTOR結構,包括 Reserved 欄位。 (提供者通常應該設定 dataDescriptor.Reserved = 0 ,如同 所完成EventDataDescCreate.) 請注意, EVENT_DATA_DESCRIPTOR 結構包含 Type 中的欄位結構 Reserved 先前為 欄位的 區段。 若要避免保留字段未初始化的提供者相容性問題 除非提供者已使用,否則 ETW 會忽略 Type 欄位 (將其視為 0) 呼叫中的 EventProviderSetTraits或EventProviderUseDescriptorType EventSetInformation。 EventInformation緩衝區應該包含BOOLEAN值 (1 位元組的值 FALSE 或 TRUE )。 |
MaxEventInfo 第一個不正確作業程式碼。 此值可能會在後續版本中變更 的 Windows SDK。 |
需求
最低支援的用戶端 | Windows 8 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2012 [傳統型應用程式 |UWP 應用程式] |
標頭 | evntprov.h |