共用方式為


WDTF 執行階段程式庫

WDTF 執行階段程式庫可作為 Windows 驅動程式套件 (WDK) 的一部分使用。 當您安裝 WDK 時,您也會安裝 Windows 驅動程式測試架構 (WDTF) 。 用於測試和開發的範本和範例檔案會與 WDK 一起安裝。 WDTF 執行階段程式庫必須安裝在您想要執行 WDTF 型測試的任何系統上。 這包括 WDK 中提供的測試,以及您使用 WDK 測試範本撰寫的測試。

WDK 也包含個別的安裝套件 (*.msi) ,可用來在測試電腦上安裝 WDTF 執行時間。 MSI 會執行下列動作:

  • 複製檔案。

  • 新增登錄機碼。

  • 註冊 WDTF 物件。

  • 安裝和解除安裝記錄檔。

WDTF 執行階段程式庫包含可協助您分級和執行測試的工具。

工具或命令指令碼的名稱 說明
CheckWDTFInstall.cmd 確認 WDTF 已正確安裝。 執行此命令會建立檔案CheckWDTFInstall.log,其中包含所有已安裝 WDTF 元件的相關資訊。
DisplayDeviceClass.vbs 顯示現行系統上存在的裝置類別資訊。 會顯示類別 GUID 和類別易記名稱。 嘗試建立尋找特定類別裝置的 /DQ 查詢時很有用。
DisplayDeviceDataFields.cmd 顯示現行系統上存在的裝置類別資訊。 會顯示類別 GUID 和類別易記名稱。 嘗試建立尋找特定類別裝置的 /DQ 查詢時很有用。
DisplayDevices.vbs 顯示 /DQ 參數所表示之每個裝置的相關資訊,預設值是系統中的所有裝置。
DisplayDevicesWithWDTFilters.vbs 顯示任何已安裝其中一個 WDTF 篩選驅動程式的裝置。 WDTF 有三個篩選驅動程式:EDT、IOSPY 或按鈕驅動程式。
DisplayDeviceTree.vbs 顯示目前系統的裝置樹狀結構。
DisplaySystemDataFields.cmd 顯示所有系統命名空間及其擁有的欄位。

如何安裝 WDTF 執行階段程式庫

當您設定要部署的測試電腦時,WDTF 執行階段程式庫會安裝在測試電腦上。 請遵循布建電腦以進行驅動程式部署和測試 (WDK 10 和 WDK 8.1) 中的指示

您也可以手動安裝 WDTF 執行階段程式庫。

在測試電腦上安裝 WDTF (慣用方法)

  1. 安裝 Visual Studio,然後安裝 WDK。

  2. 設定遠端電腦進行測試。 在 Visual Studio 中,選取 [驅動程式] 功能表,指向 [測試],然後選取 [設定電腦]。

在測試電腦上手動安裝 WDTF (替代方法)

  1. 在您用於開發的電腦上安裝 Visual Studio 和 WDK。

  2. 將 WDTF 安裝檔案從您安裝 WDK 的電腦複製到測試電腦。 WDTF 安裝檔案 (*.msi 和 *.cab 檔案) 位於開發系統上的 %programfiles%\Windows Kits\10\Testing\Runtimes 目錄中。 複製目錄中符合測試電腦架構的所有檔案。

  3. 在測試電腦上,使用提高許可權 (以系統管理員身分執行) 開啟命令提示字元視窗,並流覽至包含 WDTF 安裝檔案的目錄。 執行下列任一項命令來安裝 WDTF。

msiexec /i "OneCoreUap_WDTF_Desktop_Kit_Content-x64_en-us.msi"
msiexec /i "WDTF_Desktop_Kit_Product-x64_en-us.msi"

-或-

msiexec /i "OneCoreUap_WDTF_Desktop_Kit_Content-x86_en-us.msi"
msiexec /i "WDTF_Desktop_Kit_Product-x86_en-us.msi"

下表說明您可以與 msiexec 命令搭配使用的選項。

選項 說明
/l* 檔案名稱 將所有訊息和錯誤寫入檔案, 檔案名稱
WDTFDIR=自訂安裝目錄 設定 WDTF 執行階段的目標目錄。 預設 WDTFDir 是 %programfiles%\Windows Kits\10\Testing\Runtimes\WDTF
WDTF_SKIP_MACHINE_CONFIG=[1 | 2] 指定 1 可略過將 cscript.exe 設定為預設指令碼引擎。 指定 2 以跳過開啟 AC 和 DC RTC 喚醒。
/? 顯示 msiexec.exe 選項的幫助說明。

範例

msiexec /i "OneCoreUap_WDTF_Desktop_Kit_Content-x64_en-us.msi" /l* OneCoreUap_WDTFInstall.log WDTFDir=c:\wdtf WDTF_SKIP_MACHINE_CONFIG=1
msiexec /i "WDTF_Desktop_Kit_Product-x64_en-us.msi" /l* WDTFInstall.log WDTFDir=c:\wdtf WDTF_SKIP_MACHINE_CONFIG=1

如何判斷 WDTF 執行階段程式庫是否安裝在電腦上

您可以在測試電腦上執行命令腳本,以確認 WDTF 已正確安裝。 執行此命令會建立檔案CheckWDTFInstall.log,其中包含所有已安裝 WDTF 元件的相關資訊。

  1. 在測試電腦上開啟命令提示字元視窗。

  2. 執行 %WDTFDir%\Tools\CheckWDTFInstall.cmd

  3. CheckWDTFInstall.log開啟記錄檔並檢查結果。

如何卸載 WDTF 執行階段程式庫

當您設定要部署的測試電腦時,請遵循準備電腦以供驅動程式部署和測試 (WDK 10)的指示,WDTF 執行階段程式庫會安裝在目標電腦上。

您可以透過從目標電腦移除配置,來移除 WDTF 執行階段程式庫。 如需詳細資訊,請參閱 從目標電腦移除佈建配置

您也可以手動解除安裝 WDTF 執行階段程式庫。

在測試電腦上手動解除安裝 WDTF

  1. 在測試電腦上,移至 [設定],然後選取 [應用程式]。

  2. [程式和功能] 中,找出 Windows 驅動程式測試架構 (WDTF) 運行時間程式庫,選取並按住 (或以滑鼠右鍵按一下),然後選取 [ 解除安裝]。