WDTF ランタイム ライブラリ
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 | すべてのメッセージとエラーを 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) ランタイム ライブラリを見つけ、長押し (または右クリック)、[アンインストール] の順に選択します。