ETWENABLECALLBACK 回呼函式 (wdm.h)

EtwEnableCallback函式是選擇性驅動程式提供的回呼函式,可用來接收啟用或停用通知。

語法

ETWENABLECALLBACK Etwenablecallback;

void Etwenablecallback(
  [in]                LPCGUID SourceId,
                      ULONG ControlCode,
  [in]                UCHAR Level,
  [in]                ULONGLONG MatchAnyKeyword,
  [in]                ULONGLONG MatchAllKeyword,
  [in, optional]      PEVENT_FILTER_DESCRIPTOR FilterData,
  [in, out, optional] PVOID CallbackContext
)
{...}

參數

[in] SourceId

識別啟用提供者之會話的 GUID。

ControlCode

[in] Level

啟用事件的層級。 此參數是提供者定義的值,指定提供者寫入之事件的詳細資訊。 如果這個值小於或等於事件所定義的層級值,提供者必須寫入事件。

此值會在EnableTraceEx函式的Level參數或EnableTrace函式的EnableLevel參數中傳遞。

[in] MatchAnyKeyword

提供者用來判斷其寫入事件類別的關鍵字位元遮罩。

此值會傳入EnableTraceEx函式的MatchAnyKeyword參數或EnableTrace函式的EnableFlag參數。 MatchAnyKeyword 是 64 位值,基本上是 32 位 EnableFlag的擴充版本。

[in] MatchAllKeyword

此位元遮罩會額外限制提供者寫入的事件類別。

此值會在EnableTraceEx函式的MatchAllKeywords參數中傳遞。

[in, optional] FilterData

提供者定義的資料。 這是選擇性參數。 提供者會決定資料的版面配置及其用途。 例如,提供者可以使用此資料來額外篩選其寫入的事件,或使用它執行一些計算,再寫入事件。 如需詳細資訊,請參閱 事件篩選描述元

[in, out, optional] CallbackContext

呼叫 EtwRegister 的提供者註冊本身時所定義的回呼函式內容。 這是選擇性參數。

傳回值

備註

使用 EtwRegister 函式來指定 EtwEnableCallback 函式的指標。

使用回呼函式的 FilterData 參數,提供具有複雜篩選功能的提供者。 EtwEnableCallback函式不會取代 (EtwEventEnabledEtwProviderEnabled) 的 enable-status 函式呼叫。 不過,它可作為它們的補充。 不過,除非您的層級和關鍵字目前已啟用,否則不論回呼函式提供的 FilterData 為何,都不會寫入事件。

EtwEnableCallback的呼叫端必須在 IRQL = PASSIVE_LEVEL在系統執行緒的內容中執行。

規格需求

   
最低支援的用戶端 適用于 Windows Vista 和更新版本的 Windows。
目標平臺 桌面
標頭 wdm.h (包括 Wdm.h、Ntddk.h)
IRQL PASSIVE_LEVEL

另請參閱

EnableTrace

EnableTraceEx

EtwEventEnabled

EtwProviderEnabled

EtwRegister

事件篩選描述項