在 KMDF 驅動程式中使用 WPP 軟體追蹤

WPP 軟體追蹤 可讓您新增可協助您偵錯驅動程式的追蹤訊息。 此外，架構 的事件記錄器 會提供數百個您可以檢視的追蹤訊息。

您可以使用 TraceView 或 Tracelog來檢視追蹤訊息。 您也可以 將追蹤訊息傳送至核心偵錯工具。

將追蹤訊息新增至驅動程式

若要將追蹤訊息新增至架構型驅動程式，您必須：

• 將 #include 指示詞新增至每個驅動程式的來源檔案，其中包含任何 WPP 宏。 這個指示詞必須識別 TTL) 檔案 (追蹤訊息標頭。 檔案名的格式必須是 <driver-source-file-name.t>才能使用。

  例如，如果您的驅動程式包含兩個原始程式檔，稱為MyDriver1.c和MyDriver2.c，則 MyDriver1.c必須包含：

  #include 「MyDriver1.tー」

  和 MyDriver2.c 必須包含：

  #include 「MyDriver2.tー」

  當您在 Microsoft Visual Studio 中建置驅動程式時，WPP 預處理器會產生 。t存取 檔案。

• 在標頭檔中定義 WPP_CONTROL_GUIDS 宏。 此宏會定義驅動程式追蹤訊息的 GUID 和 追蹤旗 標。

• 在驅動程式的DriverEntry 常式中包含WPP_INIT_TRACING宏。 此宏會在驅動程式中啟動軟體追蹤。

• 在驅動程式的EvtDriverUnload 回呼函式中包含WPP_CLEANUP宏。 此宏會停用驅動程式中的軟體追蹤。

• 在驅動程式中使用 DoTraceMessage 宏或 自訂 版本的宏來建立追蹤訊息。

• 開啟驅動程式專案的 [屬性頁]。 以滑鼠右鍵按一下 方案總管 中的驅動程式專案，然後選取 [屬性]。 在驅動程式的 [屬性頁] 中，按一下 [ 組態屬性]，然後按一下 [Wpp 追蹤]。 在 [ 一般 ] 功能表下，將 [執行 WPP 追蹤 ] 設定為 [是]。 在 [ 檔案選項 ] 功能表下，您也應該指定架構的 WPP 範本檔案，例如：

  {km-WdfDefault.tpl}*.tmh
  

• 若要在 Visual Studio 中指定驅動程式專案的其他 WPP 追蹤設定，請以滑鼠右鍵按一下 [方案總管] 中的驅動程式專案。 然後遵循 Properties-Configuration > Properties-WPP > 追蹤的連結。

• 若要指定追蹤組態檔，請使用 [掃描組態資料] 設定。 針對多個追蹤組態檔，請在 [命令列] - > [其他選項] 下新增它，如下所示

  -scan:"$(KMDF_INC_PATH)\$(KMDF_VER_PATH)\wdftraceenums.h"
  

  如需將追蹤訊息新增至驅動程式的詳細資訊，請參閱 將 WPP 宏新增至驅動程式。

使用 WPP 軟體追蹤的範例驅動程式

AMCC5933、NONPNP、KMDF_FX2、PCIDRV、PLX9x5x 和序列 範例驅動程式 會使用 WPP 軟體追蹤。