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 活动,需要定义 TraceLoggingActivity 或 TraceLoggingThreadActivity 的实例。 创建其中一个类的实例后,使用 操作活动日志记录 创建其中一个类的实例后,使用 TraceLoggingFunction、 TraceLoggingWriteStart、 TraceLoggingWriteStop 和 TraceLoggingWriteTagged 操作活动日志记录。 当启用跟踪并启动活动时,此类会自动创建唯一标识符。
使用 TraceLoggingThreadActivity 对象开始日志记录时,任何活动线程将自动嵌套在此实例中。 此外,所有事件都将使用此对象的唯一标识符自动记录。
重要
仅当可以保证此线程的所有活动完全嵌套时,才使用此类。 必须确保任何子活动都不会超过父活动,即使在错误情况下或边缘情况也是如此。
注意
在 DEBUG 生成中,如果类检测到不正确的活动嵌套,或者如果 Stop 事件发生在用于启动它的线程以外的线程上,类将在 Stop 事件期间引发断言。
此类不适用于应用商店应用程序。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2012 R2 [仅限桌面应用] |
目标平台 | Windows |
标头 | traceloggingactivity.h |