WDTF 執行時間程式庫

發行項
06/15/2023

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， (慣用的方法)

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

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

在您用於開發的電腦上安裝 Visual Studio 和 WDK。
將 WDTF 安裝檔案從安裝 WDK 的電腦複製到測試電腦。 WDTF 安裝檔案 (*.msi和 *.cab檔案) 位於開發系統上的 %programfiles%\Windows Kits\10\Testing\Runtimes 目錄中。複製目錄中符合測試電腦架構的所有檔案。
在測試電腦上，使用提升許可權開啟命令提示字元視窗， (以 系統管理員 身分執行) ，然後流覽至包含 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 命令使用的選項。

選項	描述
/我* 檔案名	將所有訊息和錯誤寫入檔案、檔案名。
WDTFDIR=CustomInstallationDirectory	指定 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 元件的資訊。

在測試電腦上開啟命令提示字元視窗。
執行 %WDTFDir%\Tools\CheckWDTFInstall.cmd。
開啟記錄檔 CheckWDTFInstall.log 並檢查結果。

如何卸載 WDTF 執行時間程式庫

當您設定測試電腦以進行部署時，遵循布建電腦以進行驅動程式部署和測試 (WDK 10) ，WDTF 執行時間程式庫會安裝在目的電腦上。

您可以從目的電腦移除布建，以移除 WDTF 執行時間程式庫。如需詳細資訊，請參閱從目的電腦移除布建。

您也可以手動卸載 WDTF 執行時間程式庫。

在測試電腦上手動卸載 WDTF

在測試電腦上，移至 [ 設定 ]，然後選取 [ 應用程式]。
在 [程式和功能] 中，找出 [Windows 驅動程式測試架構] (WDTF) [執行時間程式庫]，選取並按住 (或以滑鼠右鍵按一下 [) ]，然後選取 [ 卸載]。

共用方式為