TraceLoggingThreadActivity 类 (traceloggingactivity.h)

支持在活动期间记录 ETW 事件。 事件将自动标记为此活动或将其嵌套在此活动中。

继承

TraceLoggingThreadActivity 类实现_TlgActivityBase。

方法

TraceLoggingThreadActivity 类具有这些方法。

 
TraceLoggingThreadActivity::P rovider

TraceLoggingThreadActivity::P rovider (traceloggingactivity.h) 返回与此活动关联的 TraceLogging 提供程序的句柄。
TraceLoggingThreadActivity::TraceLoggingThreadActivity

初始化 TraceLoggingThreadActivity 类的新实例。 (重载 2/2)
TraceLoggingThreadActivity::TraceLoggingThreadActivity

初始化 TraceLoggingThreadActivity 类的新实例。 (重载 1/2)

注解

此类通过设置每线程变量来工作。 只有活动线程上发生的事件才会自动标记。

若要使用 TraceLogging 活动,需要定义 TraceLoggingActivityTraceLoggingThreadActivity 的实例。 创建其中一个类的实例后,使用 操作活动日志记录 创建其中一个类的实例后,使用 TraceLoggingFunctionTraceLoggingWriteStartTraceLoggingWriteStopTraceLoggingWriteTagged 操作活动日志记录。 当启用跟踪并启动活动时,此类会自动创建唯一标识符。

使用 TraceLoggingThreadActivity 对象开始日志记录时,任何活动线程将自动嵌套在此实例中。 此外,所有事件都将使用此对象的唯一标识符自动记录。

重要

仅当可以保证此线程的所有活动完全嵌套时,才使用此类。 必须确保任何子活动都不会超过父活动,即使在错误情况下或边缘情况也是如此。

注意

在 DEBUG 生成中,如果类检测到不正确的活动嵌套,或者如果 Stop 事件发生在用于启动它的线程以外的线程上,类将在 Stop 事件期间引发断言。

此类不适用于应用商店应用程序。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 R2 [仅限桌面应用]
目标平台 Windows
标头 traceloggingactivity.h

另请参阅

TraceLoggingActivity 类