Share via

EVENT_INSTANCE_HEADER結構 (evntrace.h)

  • 發行項

EVENT_INSTANCE_HEADER 結構包含由 TraceEventInstance 所撰寫之所有事件通用的標準事件追蹤資訊。 結構也包含事件追蹤類別和相關父事件的註冊句柄，可用來追蹤相關事件之間的交易實例或階層式關聯性。

語法

typedef struct _EVENT_INSTANCE_HEADER {
  USHORT        Size;
  union {
    USHORT FieldTypeFlags;
    struct {
      UCHAR HeaderType;
      UCHAR MarkerFlags;
    } DUMMYSTRUCTNAME;
  } DUMMYUNIONNAME;
  union {
    ULONG Version;
    struct {
      UCHAR  Type;
      UCHAR  Level;
      USHORT Version;
    } Class;
  } DUMMYUNIONNAME2;
  ULONG         ThreadId;
  ULONG         ProcessId;
  LARGE_INTEGER TimeStamp;
  ULONGLONG     RegHandle;
  ULONG         InstanceId;
  ULONG         ParentInstanceId;
  union {
    struct {
      ULONG KernelTime;
      ULONG UserTime;
    } DUMMYSTRUCTNAME;
    ULONG64 ProcessorTime;
    struct {
      ULONG EventId;
      ULONG Flags;
    } DUMMYSTRUCTNAME2;
  } DUMMYUNIONNAME3;
  ULONGLONG     ParentRegHandle;
} EVENT_INSTANCE_HEADER, *PEVENT_INSTANCE_HEADER;

成員

Size

事件的位元組總數。 Size 必須包含 EVENT_INSTANCE_HEADER 結構的大小，加上附加至此結構之任何事件特定數據的大小。 大小必須小於事件追蹤會話緩衝區的大小減去 72 (0x48) 。

DUMMYUNIONNAME

各種結構和成員的聯集。

DUMMYUNIONNAME.FieldTypeFlags

保留的。

DUMMYUNIONNAME.DUMMYSTRUCTNAME

保留的。

DUMMYUNIONNAME.DUMMYSTRUCTNAME.HeaderType

保留的。

DUMMYUNIONNAME.DUMMYSTRUCTNAME.MarkerFlags

保留的。

DUMMYUNIONNAME2

類別的聯集，以兩種形式表示。

DUMMYUNIONNAME2.Version

這是 Class 成員的匯總。 低序位元組包含 Type、下一個字節包含 Level，最後兩個字節包含版本。

DUMMYUNIONNAME2.Class

類別結構。

DUMMYUNIONNAME2.Class.Type

事件類別。 提供者可以定義自己的事件類型，或使用下表所列的預先定義事件類型。

  • EVENT_TRACE_TYPE_CHECKPOINT

    Checkpoint 事件。 用於不在活動開頭或結尾的事件。

  • EVENT_TRACE_TYPE_DC_END

    數據收集結束事件。

  • EVENT_TRACE_TYPE_DC_START

    數據收集開始事件。

  • EVENT_TRACE_TYPE_DEQUEUE

    Dequeue 事件。 活動在開始之前排入佇列時使用。 使用EVENT_TRACE_TYPE_START標記工作專案排入佇列的時間。 使用清除佇列事件類型來標記專案實際開始工作時的時間。 使用EVENT_TRACE_TYPE_END來標記專案完成工作時的時間。

  • EVENT_TRACE_TYPE_END

    結束事件。 使用 來追蹤多步驟事件的最終狀態。

  • EVENT_TRACE_TYPE_EXTENSION

    擴充事件。 用於屬於上一個事件接續的事件。 例如，當事件追蹤記錄的數據超過會話緩衝區可以容納的數據時，請使用擴充事件類型。

  • EVENT_TRACE_TYPE_INFO

    資訊事件。 這是預設事件類型。

  • EVENT_TRACE_TYPE_REPLY

    回復事件。 當要求資源的應用程式可以接收多個回應時使用。 例如，如果用戶端應用程式要求 URL，而 Web 伺服器會藉由傳送數個檔案來回復，則收到的每個檔案都可以標示為回復事件。

  • EVENT_TRACE_TYPE_START

    啟動事件。 使用 來追蹤多步驟事件的初始狀態。

如果您的事件追蹤類別 GUID 支援多個事件類型，取用者會使用事件類型來判斷事件以及如何解譯其內容。

DUMMYUNIONNAME2.Class.Level

提供者定義的值，定義用來產生事件的嚴重性層級。 值的範圍從 0 到 255。 控制器會在呼叫 EnableTraceEx2 函式時指定嚴重性層級。 提供者會從其 ControlCallback 實作呼叫 GetTraceEnableLevel 函式，以擷取嚴重性層級。 提供者會使用 值來設定這個成員。

ETW 定義下列嚴重性層級。 選取高於 1 的層級也會包含較低層級的事件。 例如，如果控制器指定TRACE_LEVEL_WARNING (3) ，提供者也會產生TRACE_LEVEL_FATAL (1) ，TRACE_LEVEL_ERROR (2) 事件。

值 意義
TRACE_LEVEL_CRITICAL (1) 異常結束或終止事件
TRACE_LEVEL_ERROR (2) 嚴重錯誤事件
TRACE_LEVEL_WARNING (3) 警告事件，例如配置失敗
TRACE_LEVEL_INFORMATION (4) 非錯誤事件，例如進入或結束事件
TRACE_LEVEL_VERBOSE (5) 詳細的追蹤事件

DUMMYUNIONNAME2.Class.Version

指出您用來記錄事件的事件追蹤類別版本。 如果事件追蹤類別只有一個版本，請指定零。 版本會告知取用者要用來譯碼事件數據的MOF類別。

ThreadId

在輸出中，識別產生事件的線程。

請注意，在 Windows 2000 上， ThreadId 是 ULONGLONG 值。

ProcessId

在輸出中，識別產生事件的進程。

Windows 2000： 不支援此成員。

TimeStamp

在輸出中，包含事件發生的時間，以100奈秒間隔為單位，自1601年1月1日午夜起。

RegHandle

已註冊事件追蹤類別的句柄。 在呼叫 TraceEventInstance 函式之前設定此屬性。

RegisterTraceGuids 函式會建立此句柄 (請參閱 TraceGuidReg 參數) 。

InstanceId

在輸出中，包含與 RegHandle 相關聯的事件追蹤實例識別碼。

ParentInstanceId

在輸出中，包含與 ParentRegHandle 相關聯的事件追蹤實例識別碼。

DUMMYUNIONNAME3

結構與成員的聯集。

DUMMYUNIONNAME3.DUMMYSTRUCTNAME

結構，包含下列成員。

DUMMYUNIONNAME3.DUMMYSTRUCTNAME.KernelTime

核心模式指令的經過運行時間，以 CPU 刻度為單位。 如果您使用私人會話，請改用 ProcessorTime 成員中的值。

DUMMYUNIONNAME3.DUMMYSTRUCTNAME.UserTime

在 CPU 刻度中，使用者模式指示的經過運行時間。 如果您使用私人會話，請改用 ProcessorTime 成員中的值。

DUMMYUNIONNAME3.ProcessorTime

針對私人會話，CPU 刻度表示使用者模式指示的經過運行時間。

DUMMYUNIONNAME3.DUMMYSTRUCTNAME2

結構與成員的聯集。

DUMMYUNIONNAME3.DUMMYSTRUCTNAME2.EventId

事件識別項。

DUMMYUNIONNAME3.DUMMYSTRUCTNAME2.Flags

必須包含 WNODE_FLAG_TRACED_GUID，也可能包含下列任何組合。

  • WNODE_FLAG_USE_GUID_PTR

    指定 GuidPtr 成員是否包含類別 GUID。

  • WNODE_FLAG_USE_MOF_PTR

    指定 MOF_FIELD 結構的數位是否包含附加至這個 結構的事件數據。 陣列中的元素數目限制為 MAX_MOF_FIELDS。

ParentRegHandle

父事件的已註冊事件追蹤類別的句柄。 如果您想要追蹤 (相關事件之間的父元素/子元素) 階層式關聯性，請在呼叫 TraceEventInstance 函式之前設定此屬性。

RegisterTraceGuids 函式會建立此句柄 (請參閱 TraceGuidReg 參數) 。

備註

設定任何成員之前，請務必將此結構的記憶體初始化為零。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
標頭 evntrace.h

另請參閱

TraceEventInstance