WDK 8.1 で HCK テスト スイートを実行する方法

  • [アーティクル]

WDKでWindows ドライバー のテストを簡単にするために、WDK 8.1以降では、テストコンピューターで実行する HCKテストスイートを選択できるようになりました。 HCKテストスイートには、デバイスの基礎テストと、グラフィックス、イメージング、無線 LAN、モバイル ブロードバンド (CDMA および GSM)、および WiFi Direct デバイスのテストが含まれます。 これらは、Windows ハードウェア認定キット (Windows HCK) で使用されるテストと同じです。 Windows HCK の詳細については、「ハードウェアの Windows 認定プログラム」を参照してください。

HCK テストは、コマンド プロンプト ウィンドウまたは Visual Studio から実行できます。 さらに、これらのテストを新しい場所 (別のコンピューターまたは USB キードライブなど) にコピーし、その場所からテストを実行できます。 テストを起動すると、テストの実行に必要なローカル構成が自動的に設定されます。

Visual Studio を使ったテスト コンピューターでの HCK テスト スイートの実行

まだ行っていない場合は、「ドライバーの展開とテスト用にコンピューターをプロビジョニングする (WDK 8.1)」の手順に従ってください。 テストコンピュータを構成すると、テストコンピュータの名前がツールバーに表示されます。 HCKテストスイートでテストするデバイス用に構成したテストコンピューターを選択していることを確認してください。

必要に応じて、デバイスとドライバー、およびテストトポロジの追加要件をインストールして、テストコンピューターを準備します (テストするデバイスのHCKテストの前提条件を参照してください)。 HCK スタジオと HCK コントローラーの代わりに、Visual Studio と WDK 8.1 を使用してテストを実行します。

テスト コンピューターで実行する HCK テスト スイートの選ぶには

  1. [ドライバー] メニューで、[テスト]、[Test Group Explorer]\(テスト グループ エクスプローラー\) の順に選びます。

  2. [Driver Test Group Explorer]\(ドライバー テスト グループ エクスプローラー\) ウィンドウで、いずれかの HCK テスト スイートを選びます。

    テストスイートを選択すると、そのテストスイートがドライバー テスト グループウィンドウに表示されます。

  3. HCKテストスイートでテストするデバイス用に構成したテスト コンピューターを選択していることを確認してください。

  4. HCKテストスイートを使用するには、テストするデバイスの構成要件にも従う必要があります。

  5. チェック ボックスを使って、目的とするテスト コンピューターのアーキテクチャ (x86、x64、Arm) に対応したテストを選ぶことができます。

  6. [ドライバー] メニューで、[テスト] > [テストの実行] の順に選びます。 デフォルトでは、Runテストのコマンドは、現在選択されているテスト グループ内のすべてのテストを実行します。

提供されている HCK テストスイートの1つをコピーし、必要なテストサポートファイルとともにエクスポートして、コマンドプロンプトウィンドウからテストスイートを実行できるようにすることもできます。

テスト スイートをエクスポートするには

  1. [Test Group Explorer]\(テスト グループ エクスプローラー\) で、コピーする HCK テスト スイートを長押し (または右クリック) し、ショートカット メニューから [Export Test Suite...]\(テスト スイートのエクスポート...\) をクリックします。 (コマンドは CopyMe.cmd スクリプトを実行します)。
  2. テストスイートの宛先フォルダーを選択します。 テスト スイートをネットワーク共有または USB フラッシュ ドライブにエクスポートできます。
  3. HCKテストスイートを実行するには、昇格されたアクセス許可を使用してテストコンピューター上でコマンドプロンプトウィンドウを開きます。 宛先ディレクトリに移動し、RunMe.cmd スクリプトを実行します。 詳細については、コマンド プロンプト ウィンドウからHCKテスト スイートを実行するにはを参照してください。

コマンド プロンプト ウィンドウからの HCK テスト スイートの実行

HCK テスト スイートのコピー

  1. Visual Studio のコマンド プロンプト ウィンドウを開きます。 %WindowsSdkDir%\Testing\Tests\HCK Tests\Basic ディレクトリに移動します (例: C:\Program Files (x86)\Windows Kits\8.1\Testing\Tests\HCK Tests\Basic)。

  2. CopyMe.cmd スクリプトを実行し、テストスイートの名前と宛先ディレクトリを指定します。 スクリプトの構文は次のとおりです。

    CopyMe.cmd testSuite destinationPath

    testSuite は次のいずれかです。

    • デバイス.デバイスの基礎

    • Device.Graphics

    • Device.Imaging

    • デバイス.ネットワーク.モバイルブロードバンド.CDMA

    • デバイス.ネットワーク.モバイルブロードバンド.GSM

    • デバイス.ネットワーク.WLAN

    destinationPath には、UNC パスを含む任意の有効なパスを指定できます。 たとえば、HCKテスト スイートを USBフラッシュドライブやサーバー上の共有にコピーできます。

    C:\Program Files (x86)\Windows Kits\8.1\Testing\Tests\HCK Tests\Basic>CopyMe "De
vice.Device Fundamentals" d:\temp\devfund
Copying test target setup installers
Copying TAEF and WDTF infrastructure
Copying debuggers infrastructure
Copying x86 tools
Copying x64 tools
Copying arm tools
Copying test suite
Copy complete!

Run on any computer using an administrator command prompt in the same folder as
the RunMe.cmd script.
"RunMe.cmd <infFileName>"

注 テスト コンピューターで Windows 7 を実行している場合、HCK テスト スイートを実行する前に Microsoft .NET Framework 4.5 をダウンロードしてインストールする必要があります。

コマンド プロンプト ウィンドウからの HCK テスト スイートを実行するには

  1. テスト用に構成したテストコンピューターで、管理者特権 (管理者として実行) でコマンド プロンプトウィンドウを開き、HCKテストスイートをコピーしたディレクトリに移動します。

  2. RunMe.cmd スクリプトを実行し、INFファイルのパスと名前を指定します。 スクリプトの構文は次のとおりです。

    RunMe.cmd infFileName

    次に例を示します。

    RunMe.cmd myDriver.inf

    注 Device.Graphics テスト スイートは INF ファイルを使いませんが、RunMe.cmd スクリプトには INF ファイルが必要です。 必要に応じて、代替INFファイルの名前を指定できます。

HCT テスト スイート

テストパラメーターの指定については、デバイスの基礎のテストパラメーターを参照してください。 テスト対象デバイスまたはその子デバイスの1つが WiFi アダプターまたはネットワーク デバイスである場合、Wpa2PskAesSsid、Wpa2PskPassword、またはWDTFREMOTESYSTEM パラメーターの設定が必要になる場合があります。

HCK Tests.Basic.Device.Device Fundamentals Test Suite

このテストスイートは、すべてのデバイスタイプの一般的な信頼性テストに使用します。 Device.Fundamentals 信頼性テストの前提条件で説明されている HCKテストのハードウェア、ソフトウェア、およびテスト要件に従う必要があります。 HCK スタジオと HCK コントローラーの代わりに、Visual Studio と WDK 8.1 を使用して基本テストを実行します。

HCK Tests.Basic.Device.Device Fundamentals Test Suite
ハードウェア要件、ソフトウェア要件、テスト要件

Device.Fundamentals の信頼性テストの前提条件
テストの概要

DF - 前後の I/O を伴う PNP (無効化/有効化) (基本)

DF - 前後の I/O を伴うスリープ (基本)

HCK Tests.Basic.Device.Graphics Test Suite

このテストスイートを使用して、グラフィックアダプターまたはチップセットをテストします。 グラフィックアダプターまたはチップセットのテストの前提条件で説明されているように、HCKテストのハードウェア、ソフトウェア、およびテスト要件に従う必要があります。 HCK スタジオと HCK コントローラーの代わりに、Visual Studio と WDK 8.1 を使用して基本テストを実行します。

HCK Tests.Basic.Device.Graphics Test Suite
ハードウェア要件、ソフトウェア要件、テスト要件 グラフィック アダプターまたはチップセットのテストの前提条件
テストの概要 グラフィック アダプターまたはチップセットのテストに関するページ

HCK Tests.Basic.Device.Imaging Test Suite

このテストスイートを使用してプリンターをテストします。 テストスイートは、HCK Device.Imaging Testingの一部であるテストを使用します。 HCK スタジオと HCK コントローラーの代わりに、Visual Studio と WDK 8.1 を使用して基本テストを実行します。

HCK Tests.Basic.Device.Imaging Test Suite
ハードウェア要件、ソフトウェア要件、テスト要件

プリンターのテストの前提条件
テストの概要

プリンター テスト

HCK Tests.Basic.Device.Network.MobileBroadband.CDMA Test Suite

このテストスイートを使用して、モバイルブロードバンドCDMAのデバイスをテストします。 モバイルブロードバンド テストの前提条件に記載されているデバイスのセットアップと構成のガイドラインに従ってください。 HCK スタジオと HCK コントローラーの代わりに、Visual Studio と WDK 8.1 を使用して基本テストを実行します。

HCK Tests.Basic.Device.Network.MobileBroadband.CDMA Test Suite
ハードウェア要件、ソフトウェア要件、テスト要件

モバイル ブロードバンドのテストの前提条件
テストの概要

CDMA テスト

HCK Tests.Basic.Device.Network.MobileBroadband.GSM Test Suite

このテストスイートを使用して、モバイルブロードバンドGSMのデバイスをテストします。 モバイルブロードバンド テストの前提条件に記載されているデバイスのセットアップと構成のガイドラインに従ってください。 HCK スタジオと HCK コントローラーの代わりに、Visual Studio と WDK 8.1 を使用して基本テストを実行します。

HCK Tests.Basic.Device.Network.MobileBroadband.GSM Test Suite
ハードウェア要件、ソフトウェア要件、テスト要件

モバイル ブロードバンドのテストの前提条件
テストの概要

GSM テスト

HCK Tests.Basic.Device.Network.WLAN Test Suite

このテストスイートを使用して、無線 LAN (802.11)デバイスをテストします。 HCK向けワイヤレス LAN (802.11) テストの前提条件で説明されているデバイスのセットアップと構成のガイドラインに従ってください。 HCK スタジオと HCK コントローラーの代わりに、Visual Studio と WDK 8.1 を使用して基本テストを実行します。

HCK Tests.Basic.Device.Network.WLAN Test Suite
ハードウェア要件、ソフトウェア要件、テスト要件

ワイヤレス LAN (802.11) のテストの前提条件
テストの概要

WLAN L1 テスト