etwEventEnabled 函式 (wdm.h)

EtwEventEnabled 函式會驗證事件是否已啟用。

語法

BOOLEAN EtwEventEnabled(
  [in] REGHANDLE          RegHandle,
  [in] PCEVENT_DESCRIPTOR EventDescriptor
);

參數

[in] RegHandle

事件提供者註冊句柄的指標,如果事件提供者註冊成功, 則 EtwRegister 函式會傳回此指標。

[in] EventDescriptor

常數EVENT_DESCRIPTOR的指標。

傳回值

如果已啟用事件, EtwEventEnabled 函式會傳回 TRUE ;如果未啟用事件,則會傳回 FALSE

備註

如果記錄事件需要額外的運算, 則 EtwEventEnabled 函式可用來判斷是否要記錄事件,這會在停用記錄時將額外負荷降到最低。

如果事件描述元無法使用,請改用 EtwProviderEnabled 函式

規格需求

需求
最低支援的用戶端 適用於 Windows Vista 和更新版本的 Windows。
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL 任何層級

另請參閱

EtwProviderEnabled