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

另請參閱

EventSetInformation

提供者特性