将 WPP 宏添加到跟踪提供程序

  • 项目

若要将 WPP 软件跟踪的默认形式添加到 跟踪提供程序（例如内核模式驱动程序或用户模式应用程序），请将以下 C 预处理器指令和 WPP 宏调用添加到提供程序的源代码：

  • 对包含任何 WPP 宏的每个源文件采用以下格式 的#include 指令。 此语句包括 WPP 预处理器为每个源文件创建的跟踪消息头文件：

    #include <source-file-name.tmh>

    在调用任何 WPP 宏之前以及定义 WPP_CONTROL_GUIDS 宏之后，跟踪消息头文件必须包含在源文件中。

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

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

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

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

    对于用户模式应用程序，请在源代码中之前未尝试进行跟踪的某个点调用此宏。

    初始化后，可以使用 TraceView 或 Tracelog 启动软件跟踪会话并显示跟踪消息。

  • 一 WPP_CLEANUP 对 跟踪提供程序源代码的 宏调用。 此宏停用驱动程序中的软件跟踪。

    对于驱动程序，此宏调用通常会添加到驱动程序的 Unload 例程。

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

  • DoTraceMessage 宏调用以记录跟踪消息。