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)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL 任何级别

另请参阅

EtwProviderEnabled