将 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 宏调用以记录跟踪消息。