次の方法で共有

テスト メタデータを追加する方法

  • [アーティクル]

Windows 8の場合、Windows Driver Kit (WDK) はテストコンテンツの作成にTest Authoring and Execution Framework (TAEF) を使用します。 TAEF テストは、複数のメソッドを含むダイナミックリンク ライブラリ (DLL) として実装されたオブジェクトであり、各メソッドは特定のテスト シナリオにマップされます。 TAEF オブジェクトは、関連するメソッドをテストのグループに結合します。 各テストには、テストを説明する一連のメタデータがあります。 テストの移植性とカプセル化を向上させるために、TAEF はテストメタデータをテストオブジェクト自体に保存します。 ドライバー テスト テンプレートを使用して独自のドライバーテストを作成する場合、ドライバー テストが利用可能になり、Visual Studio を使用して展開できるように、このメタデータを追加する必要があります。

前提条件

テスト メタデータ属性を追加するには

  1. 必要なテストプロパティのメタデータをテストのソースファイルに追加します。

  2. たとえば、ドライバーテストのテンプレートを使用して独自のバージョンの SurpriseRemove テストを作成する場合、次のメタデータが追加されます。 テストの説明、表示名、カテゴリ、および結果ファイルの属性を編集します。

    C++ 
    // Declare the test class method DoSurpriseRemove - the main test method within this class
    BEGIN_TEST_METHOD(DoSurpriseRemove)
    // Required properties for driver tests
    TEST_METHOD_PROPERTY(L"Kits.Drivers", L"TRUE")
    TEST_METHOD_PROPERTY(L"Kits.Parameter", L"DQ")
    TEST_METHOD_PROPERTY(L"Kits.Parameter.DQ.Description", L"A WDTF SDEL query that is used to identify the target device(s) - https://go.microsoft.com/fwlink/p/?linkid=232678")
    TEST_METHOD_PROPERTY(L"Kits.Parameter.DQ.Default", L"INF::OriginalInfFileName='%InfFileName%'")  
    TEST_METHOD_PROPERTY(L"RebootPossible", L"true")
    // TODO: Required properties to be customized to match your test requirements
    TEST_METHOD_PROPERTY(L"Description", L"Plug and Play Surprise Remove Generated Template")
    TEST_METHOD_PROPERTY(L"Kits.DisplayName", L"My Plug and Play Surprise Remove Test") 
    TEST_METHOD_PROPERTY(L"Kits.Category", L"My Test Category")
    // Optional properties for driver tests
    TEST_METHOD_PROPERTY(L"Kits.Drivers.ResultFile", L"TestTextLog.log")
    // TODO: (see Windows Driver Kit documentation for additional optional properties)
    END_TEST_METHOD()
    C# 
    //
    // DoSurpriseRemove is a test method as identified by the [TestMethod] tag. 
    // More methods can be added by following this basic pattern.
    // The name of the function defines the name of the test.
    //
    [TestMethod]
    // Required properties (see Windows Driver Kit documentation for more information):
    [TestProperty("Kits.Drivers", "TRUE")]
    [TestProperty("Kits.Parameter", "DQ")]
    [TestProperty("Kits.Parameter.DQ.Description", "A WDTF SDEL query that is used to identify the target device(s) - https://go.microsoft.com/fwlink/p/?linkid=232678")]
    [TestProperty("Kits.Parameter.DQ.Default", "INF::OriginalInfFileName='%InfFileName%'")]
    // TODO: Required properties to be customized to match your test requirements.
    [TestProperty("Description", "Plug and Play Surprise Remove Generated Template")]
    [TestProperty("Kits.DisplayName", "My Plug and Play Surprise Remove Test")]
    [TestProperty("Kits.Category", "My Test Category")]
    [TestProperty("RebootPossible", "true")]
    // Optional properties (see Windows Driver Kit documentation for additional optional properties):
    [TestProperty("Kits.Drivers.ResultFile", "TestTextLog.log")]

    Windows スクリプト コンポーネント (.wsc)

    <!-- Define a test method with metadata: -->
    <method name="PlugAndPlaySurpriseRemoveTest">
    <!-- Required properties for ERT-->
    <TestMethodProperty name="Kits.Drivers" value="TRUE"/>
    <TestMethodProperty name="Kits.Parameter" value="DQ"/>
    <TestMethodProperty name="Kits.Parameter.DQ.Description" value="A WDTF SDEL query that is used to identify the target device(s) - https://go.microsoft.com/fwlink/p/?linkid=232678"/>
    <TestMethodProperty name="Kits.Parameter.DQ.Default" value="INF::OriginalInfFileName='%InfFileName%'"/>
    <TestMethodProperty name="RebootPossible" value="true" />
    <!-- TODO: Properties to be customized to match your test requirements -->
    <TestMethodProperty name="Description" value="Plug and Play Surprise Remove Generated Template"/>
    <TestMethodProperty name="Kits.DisplayName" value="My Plug and Play Surprise Remove Test"/>
    <TestMethodProperty name="Kits.Category" value="My Test Category"/>
    <!-- Optional properties for ERT-->
    <TestMethodProperty name="Kits.Drivers.ResultFile" value="TestTextLog.log"/>
    <!-- (see Windows Driver Kit documentation for additional optional properties) -->
    </method>

  3. 次の表では、テストプロパティの属性について説明します。 テストのメタデータを編集または追加するときは、例をガイダンスとして使用してください。

    説明
    テストの内容についての簡単な説明。

    [Script] 
  < TestProperty name="Description" value= "This test cycles the system through various sleep states and performs IO on devices before and after each sleep state cycle"/>

    C++ 
    [C++] 
    TEST_METHOD_PROPERTY(L"Description", L"Plug and Play Surprise Remove Generated Template")

    表示名
    ドライバーテストに表示されているテストの名前。

    [スクリプト] 
    < TestProperty name="Kits.DisplayName" value="Sleep with IO Before and After"/>

    C++ 
     [C++] 
    TEST_METHOD_PROPERTY(L"Kits.DisplayName", L"My Plug and Play Surprise Remove Test")

    Kits.Parameter
    メソッド呼び出しの標準パラメータ。 テストには複数のパラメーターを含めることができます。

    [スクリプト] 
    <ModuleProperty name="Kits.Parameter" value="TM"/>

    C++ 
    [C++] 
    TEST_METHOD_PROPERTY(L"Kits.Parameter", L"DQ")

    Kits.Parameter.<パラメーター名>.Description
    パラメータの説明。

    [スクリプト] 
    < TestProperty name="Kits.Parameter.TM.Description" value="Test mode parameter: Logo or Simple"/>

    C++ 
     [C++] 
    TEST_METHOD_PROPERTY(L"Kits.Parameter.DQ.Description", L"A WDTF SDEL query that is used to identify the target device(s)")

    Kits.Parameter.<パラメーター名>.Default
    パラメーターの既定値です。

    [スクリプト] 
    < TestProperty name="Kits.Parameter.TM.Default" value="Logo"/>

    C++ 
    [C++] 
    TEST_METHOD_PROPERTY(L"Kits.Parameter.DQ.Default", L"INF::OriginalInfFileName='%InfFileName%'")

    Kits.Drivers
    この属性は、WDKに含めるかどうかのテストをマークします。

    [スクリプト] 
    < TestProperty name="Kits.Drivers" value=""/>

    C++ 
    [C++] 
    TEST_METHOD_PROPERTY(L"Kits.Drivers", L"TRUE")

    Kits.Category
    テストのカテゴリを説明します。

     [スクリプト] 
    < TestProperty name="Kits.Category" value="Logo\Device Fundamentals"/>

    C++ 
     [C++] 
    TEST_METHOD_PROPERTY(L"Kits.Category", L"My Test Category")

    Deploymentitem
    ファイルやフォルダーをテストの依存関係として識別します。 これらには、テストの実行に必要なリソースが含まれる場合があります。 このメタデータの使用の詳細については、DeploymentItem Metadataを参照してください。