共用方式為


ENABLE_TRACE_PARAMETERS_V1結構 (evntrace.h)

ENABLE_TRACE_PARAMETERS_V1結構包含用來透過EnableTraceEx2啟用提供者的資訊。 這個結構已過時。 請改用 ENABLE_TRACE_PARAMETERS

語法

typedef struct _ENABLE_TRACE_PARAMETERS_V1 {
  ULONG                    Version;
  ULONG                    EnableProperty;
  ULONG                    ControlFlags;
  GUID                     SourceId;
  PEVENT_FILTER_DESCRIPTOR EnableFilterDesc;
} ENABLE_TRACE_PARAMETERS_V1, *PENABLE_TRACE_PARAMETERS_V1;

成員

Version

設定為 ENABLE_TRACE_PARAMETERS_VERSION (1) 。

EnableProperty

撰寫事件時,ETW 可包含的選擇性資訊。 資料會寫入事件的 擴充資料項目 區段。 若要包含選擇性資訊,請指定下列一或多個旗標;否則,請將 設定為零。

  • EVENT_ENABLE_PROPERTY_SID

    包含在延伸資料中,使用者 (SID) 的安全性識別碼。

  • EVENT_ENABLE_PROPERTY_TS_ID

    包含在終端機會話識別碼的擴充資料中。

  • EVENT_ENABLE_PROPERTY_STACK_TRACE

    將呼叫堆疊追蹤新增至使用 EventWrite寫入之事件的擴充資料。

    注意

    如果事件大小總計超過 64K,ETW 將會卸載事件。 如果提供者正在記錄大小接近 64K 上限的事件,啟用堆疊擷取可能會導致事件遺失。

    如果堆疊超過 192) 192 (的最大畫面格數目,則會從堆疊底部剪下框架。

    對於取用者,事件會包含 EVENT_EXTENDED_ITEM_STACK_TRACE32EVENT_EXTENDED_ITEM_STACK_TRACE64 擴充專案。 請注意,32 位取用者可能會從 64 位進程接收 64 位堆疊追蹤。

ControlFlags

保留的。 設定為 0。

SourceId

GUID,可唯一識別啟用或停用提供者的呼叫端。 如果提供者未實作 EnableCallback,則不會使用 GUID。

EnableFilterDesc

指向篩選資料的 EVENT_FILTER_DESCRIPTOR 結構。 提供者會使用篩選資料來防止符合篩選準則的事件寫入會話。 提供者會決定資料的版面配置,以及如何將篩選套用至事件的資料。 會話只能將一個篩選傳遞給提供者。

會話可以呼叫 TdhEnumerateProviderFilters 函式,以判斷它可以傳遞給提供者的架構化篩選。

備註

ENABLE_TRACE_PARAMETERS_V1 已過時。 ENABLE_TRACE_PARAMETERS結構是第 2 版結構,並取代ENABLE_TRACE_PARAMETERS_V1結構。

一般而言,在 64 位電腦上,當不允許分頁錯誤時,您無法在特定內容中擷取核心堆疊。 若要啟用在 x64 上執行核心堆疊,請將記憶體管理登錄值設定 DisablePagingExecutive 為 1。 登錄 DisablePagingExecutive 值位於下列登錄機碼底下: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Memory Management 。 這應該僅供暫時診斷之用,因為它會增加系統的記憶體使用量。

需求

   
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
標頭 evntrace.h

另請參閱

ENABLE_TRACE_PARAMETERS

EVENT_FILTER_DESCRIPTOR

EnableTraceEx2