向跟踪提供程序中添加 WPP 宏

要向一个跟踪提供程序(例如内核模式驱动程序或用户模式应用程序)添加默认形式的 WPP 软件跟踪,可向提供程序的源代码中添加以下 C 预处理器指令和 WPP 宏调用:

  • 将以下形式的 #include 指令添加到包含任何 WPP 宏的每个源文件中。此语句包含每个源文件的 WPP 预处理器创建的跟踪消息头文件
    
    #include <source-file-name.tmh>
    
    

    跟踪消息头文件必须包含在源文件中,放在任何 WPP 宏调用之前和一个 WPP_CONTROL_GUIDS 宏定义之后。

  • 向包含其他 WPP 宏的每个源文件添加 WPP_CONTROL_GUIDS 定义指令。

    此定义指定驱动程序的控制 GUID 和驱动程序定义的跟踪标志名称。该定义必须添加到源文件中,放在包含文件的跟踪消息头文件的 #include 语句之前。

  • 对驱动程序源代码的一个 WPP_INIT_TRACING 宏调用。

    对于驱动程序,此宏激活驱动程序中的软件跟踪。此宏通常在驱动程序初始化期间调用,例如在一个 DriverEntry 例程中。

    对于用户模式应用程序,在源代码中没有进行过任何跟踪尝试的位置调用此宏。

    初始化后,可以使用 TraceViewTracelog 启动一个软件跟踪会话并显示跟踪消息。

  • 跟踪提供程序的源代码的一次 WPP_CLEANUP 宏调用。此宏取消激活驱动程序中的软件跟踪。

    对于驱动程序,通常将此宏调用添加到驱动程序的 Unload 例程中。

    对于用户模式应用程序,在源代码中进行最后一次跟踪尝试之后调用此宏。

  • 日志跟踪消息的 DoTraceMessage 宏调用。

 

 

显示:
© 2015 Microsoft