Share via

將 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 常式中。

    針對使用者模式應用程式，請在原始程式碼中，于先前未嘗試追蹤的某個時間點呼叫此宏。

    初始化之後，您可以使用 TraceView 或 Tracelog 來啟動軟體追蹤會話，並顯示追蹤訊息。

  • 一 個WPP_CLEANUP 宏呼叫 追蹤提供者的 原始程式碼。 此宏會停用驅動程式中的軟體追蹤。

    對於驅動程式，此宏呼叫通常會新增至驅動程式的 Unload 常式。

    針對使用者模式應用程式，請在上次追蹤嘗試之後，于原始程式碼的某個時間點呼叫此宏。

  • DoTraceMessage 宏呼叫以記錄追蹤訊息。