共用方式為


ENABLE_TRACE_PARAMETERS結構 (evntrace.h)

ENABLE_TRACE_PARAMETERS結構包含用來透過EnableTraceEx2啟用提供者的資訊。

語法

typedef struct _ENABLE_TRACE_PARAMETERS {
  ULONG                    Version;
  ULONG                    EnableProperty;
  ULONG                    ControlFlags;
  GUID                     SourceId;
  PEVENT_FILTER_DESCRIPTOR EnableFilterDesc;
  ULONG                    FilterDescCount;
} ENABLE_TRACE_PARAMETERS, *PENABLE_TRACE_PARAMETERS;

成員

Version

設定為 ENABLE_TRACE_PARAMETERS_VERSION_2 (2) 。

EnableProperty

撰寫事件時,ETW 可以包含的選擇性設定。 某些設定會將額外的資料寫入每個事件的 擴充資料項目 區段。 其他設定可控制追蹤中將包含哪些事件。 若要使用這些選擇性設定,請指定下列一或多個旗標。 否則,請將 設定為零。

  • EVENT_ENABLE_PROPERTY_IGNORE_KEYWORD_0

    篩選出事件關鍵字為 0 的事件。

    Windows 10 1507 版和更新版本支援。 透過修補程式Windows 8.1和 Windows 7 SP1 也支援此功能。

  • EVENT_ENABLE_PROPERTY_PROVIDER_GROUP

    表示此對 EnableTraceEx2 的呼叫應該啟用 提供者群組 ,而不是個別的事件提供者。

    Windows 10 1507 版和更新版本支援。 透過修補程式Windows 8.1和 Windows 7 SP1 也支援此功能。

  • EVENT_ENABLE_PROPERTY_PROCESS_START_KEY

    在擴充資料中包含進程啟動金鑰。

    進程啟動金鑰是識別進程的序號。 雖然進程識別碼可以在會話內重複使用,但進程啟動金鑰保證在目前的開機會話中是唯一的。

    Windows 10 1507 版和更新版本支援。 透過修補程式Windows 8.1和 Windows 7 SP1 也支援此功能。

  • EVENT_ENABLE_PROPERTY_EVENT_KEY

    在擴充資料中包含事件索引鍵。

    事件索引鍵是事件實例的唯一識別碼,在接聽此事件的多個追蹤會話之間會是常數。 它可用來讓同時追蹤會話相互關聯。

    Windows 10 1507 版和更新版本支援。

  • EVENT_ENABLE_PROPERTY_EXCLUDE_INPRI加值稅E

    篩選出標示為 InPrivate 事件的所有事件,或來自標示為 InPrivate 的進程。

    InPrivate 表示事件或進程包含一些被視為私人或個人的資料。 由進程或事件決定,將本身指定為 InPrivate,才能運作。

    Windows 10 1507 版和更新版本支援。

  • EVENT_ENABLE_PROPERTY_SID

    在事件的擴充資料中包含使用者的安全性識別碼 (SID) 。

    Windows Vista 和更新版本支援。

  • EVENT_ENABLE_PROPERTY_TS_ID

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

    Windows Vista 和更新版本支援。

  • EVENT_ENABLE_PROPERTY_STACK_TRACE

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

    注意

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

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

    對於取用者,事件會包含 EVENT_EXTENDED_ITEM_STACK_TRACE32EVENT_EXTENDED_ITEM_STACK_TRACE64 擴充專案。 請注意,在 64 位電腦上,即使追蹤是由 32 位追蹤控制器啟動,追蹤也會包含這兩個 64 位堆疊。

    Windows 7 和更新版本支援。

ControlFlags

保留的。 設定為 0。

SourceId

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

EnableFilterDesc

指向篩選資料 之EVENT_FILTER_DESCRIPTOR 結構的陣列指標。 陣列中的專案數目是在 FilterDescCount 成員中指定。 每個篩選類型只能有一個描述元,如EVENT_FILTER_DESCRIPTOR結構的Type成員所指定。

FilterDescCount

enableFilterDesc成員所指向EVENT_FILTER_DESCRIPTOR陣列中篩選) (元素數目。

FilterDescCount成員應該符合EnableFilterDesc成員所指向之陣列中的EVENT_FILTER_DESCRIPTOR結構數目。

備註

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

Windows 8.1、Windows Server 2012 R2 及更新版本:EnableTraceEx2函式和ENABLE_TRACE_PARAMETERSEVENT_FILTER_DESCRIPTOR結構可以使用事件承載、範圍和堆疊逐步解說篩選準則,以篩選記錄器會話中的特定條件。 如需事件承載篩選的詳細資訊,請參閱 EnableTraceEx2TdhCreatePayloadFilterTdhAggregatePayloadFilters 函式和 EVENT_FILTER_DESCRIPTORPAYLOAD_FILTER_PREDICATE 結構。

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

需求

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

另請參閱

EVENT_FILTER_DESCRIPTOR

EVENT_FILTER_EVENT_ID

PAYLOAD_FILTER_PREDICATE

EnableTraceEx2

TdhAggregatePayloadFilters

TdhCreatePayloadFilter

TdhEnumerateProviderFilters