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 | 任何级别 |