WDTF ランタイム ライブラリは、Windows Driver Kit (WDK) の一部として使用できます。 WDK をインストールすると、Windows Driver Test Framework (WDTF) もインストールされます。 テストおよび開発用のテンプレートとサンプル ファイルは、WDK と共にインストールされます。 WDTF ベースのテストを実行するシステムには、WDTF ランタイム ライブラリをインストールする必要があります。 これには、WDK で提供されるテストと、WDK テスト テンプレートを使用して記述するテストが含まれます。
WDK には、テスト コンピューターに WDTF ランタイムをインストールするために使用できる個別のインストール パッケージ (*.msi) も含まれています。 MSI は次の処理を行います。
ファイルをコピーします。
レジストリ キーを追加します。
WDTF オブジェクトを登録します。
ログ ファイルをインストールしてアンインストールします。
WDTF ランタイム ライブラリには、テストのトリアージと実行に役立つツールが含まれています。
| ツールまたはコマンド スクリプトの名前 | 説明 |
|---|---|
| CheckWDTFInstall.cmd | WDTF が正しくインストールされたことを確認します。 このコマンドを実行すると、インストールされているすべての WDTF コンポーネントに関する情報を含むファイル CheckWDTFInstall.logが作成されます。 |
| DisplayDeviceClass.vbs | 現在のシステムに存在するデバイス クラス情報を表示します。 クラス GUID とクラス フレンドリ名の両方が表示されます。 特定のクラスのデバイスを検索する /DQ クエリを作成しようとするときに便利です。 |
| DisplayDeviceDataFields.cmd | 現在のシステムに存在するデバイス クラス情報を表示します。 クラス GUID とクラス フレンドリ名の両方が表示されます。 特定のクラスのデバイスを検索する /DQ クエリを作成しようとするときに便利です。 |
| DisplayDevices.vbs | /DQ パラメーターで表される各デバイスに関する情報を表示します。既定値はシステム内のすべてのデバイスです。 |
| DisplayDevicesWithWDTFilters.vbs | WDTF フィルター ドライバーのいずれかがインストールされているデバイスを表示します。 WDTF には、EDT、IOSPY、またはボタン ドライバーの 3 つのフィルター ドライバーがあります。 |
| DisplayDeviceTree.vbs | 現在のシステムのデバイス ツリーを表示します。 |
| DisplaySystemDataFields.cmd | すべてのシステム名前空間と、その名前空間に含まれるフィールドが表示されます。 |
WDTF ランタイム ライブラリをインストールする方法
展開用のテスト コンピューターを設定すると、WDTF ランタイム ライブラリがテスト コンピューターにインストールされます。 ドライバーの展開とテスト用にコンピューターをプロビジョニングする (WDK 10 および WDK 8.1) の手順に従います
WDTF ランタイム ライブラリを手動でインストールすることもできます。
テスト コンピューターへの WDTF のインストール (推奨される方法)
Visual Studio をインストールし、WDK をインストールします。
テスト用にリモート コンピューターを構成します。 Visual Studio で[ ドライバー ] メニューを選択し、[ テスト] をポイントして、[ コンピューターの構成] を選択します。
テスト コンピューターに WDTF を手動でインストールする (別の方法)
開発に使用するコンピューターに Visual Studio と WDK をインストールします。
WDK をインストールしたコンピューターからテスト コンピューターに WDTF インストール ファイルをコピーします。 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 コマンドで使用できるオプションについて説明します。
| 選択肢 | 説明 |
|---|---|
| /l* filename | すべてのメッセージとエラーをファイル名に書き込 みます。 |
| WDTFDIR=CustomInstallationDirectory | WDTF ランタイムの宛先ディレクトリを指定します。 既定 の WDTFDir は %programfiles%\Windows Kits\10\Testing\Runtimes\WDTF です |
| WDTF_SKIP_MACHINE_CONFIG=[1 | 2] | 既定のスクリプト エンジンとして cscript.exe 設定をスキップするには 、1 を指定します。 AC および DC RTC ウェイクの有効化をスキップするには 、2 を指定します。 |
| /? | 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 が正しくインストールされたことを確認するには、テスト コンピューターでコマンド スクリプトを実行します。 このコマンドを実行すると、インストールされているすべての WDTF コンポーネントに関する情報を含むファイル CheckWDTFInstall.logが作成されます。
テスト コンピューターでコマンド プロンプト ウィンドウを開きます。
%WDTFDir%\Tools\CheckWDTFInstall.cmdを実行します。CheckWDTFInstall.logログ ファイルを開き、結果を確認します。
WDTF ランタイム ライブラリをアンインストールする方法
展開用にテスト コンピューターを設定する場合は、「ドライバーの 展開とテスト用にコンピューターをプロビジョニングする (WDK 10)」の手順に従って、WDTF ランタイム ライブラリがターゲット コンピューターにインストールされます。
ターゲット コンピューターからプロビジョニングを削除することで、WDTF ランタイム ライブラリを削除できます。 詳細については、「 ターゲット コンピューターからのプロビジョニングの削除」を参照してください。
WDTF ランタイム ライブラリを手動でアンインストールすることもできます。
テスト コンピューターでの WDTF の手動アンインストール
テスト コンピューターで 、[設定] に移動し、[ アプリ] を選択します。
[プログラムと機能] で、Windows Driver Testing Framework (WDTF) ランタイム ライブラリを見つけ、長押し (または右クリック)、[アンインストール] の順に選択します。