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 | 任何層級 |