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 中可用。
目标平台 普遍
标头 wdm.h (包括 Wdm.h、Ntddk.h)
NtosKrnl.lib
DLL NtosKrnl.exe
IRQL 任何级别

另请参阅

EtwProviderEnabled