如何添加测试元数据

项目
03/08/2023

对于 Windows 8，Windows 驱动程序工具包 (WDK) 使用测试创作和执行框架 (TAEF) 来创建测试内容。 TAEF 测试是以包含多个方法的动态链接库 (DLL) 形式实现的对象，其中的每个方法均映射到特定的测试方案。 TAEF 对象将相关方法合并为一个测试组。对于每个测试，均有一组描述该测试的元数据。为了提高测试可移植性和封装，TAEF 将测试元数据存储在测试对象本身中。在使用驱动程序测试模板创建自己的驱动程序测试时，你需要添加该元数据，以便驱动程序测试可用，并可以使用 Visual Studio 部署。

先决条件

使用其中一个驱动程序测试模板编写的驱动程序测试的源代码。有关信息，请参阅如何使用驱动程序测试模板编写驱动程序测试。

添加测试元数据属性

将所需的测试属性元数据添加到测试的源文件。

例如，如果你使用“驱动程序测试”模板创建 SurpriseRemove 测试的版本，则添加以下元数据。编辑测试说明、显示名称、类别和结果文件属性。

C++

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()

// 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")]

//
    // 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>

下表介绍测试的属性特性。在编辑或添加测试元数据时，请使用示例作为指南。

Description
对测试任务的简短说明。

[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")`

DisplayName
在“驱动程序测试”中显示的测试名称。

              
              [Script] < 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
方法调用的标准参数。一个测试可以有多个参数。

              
              [Script] <ModuleProperty name="Kits.Parameter" value="TM"/>

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

Kits.Parameter.<ParameterName>.Description
参数的说明。

              
              [Script] < 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.<ParameterName>.Default
参数的默认值。

              
              [Script] < 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 中。

              
              [Script] < TestProperty name="Kits.Drivers" value=""/>

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

Kits.Category
描述测试的类别。

              
               [Script] < TestProperty name="Kits.Category" value="Logo\Device Fundamentals"/>

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

Deploymentitem
将文件和/或文件夹标识为测试依赖项。这些可能包含运行测试所需的任何资源。有关使用此元数据的详细信息，请参阅 DeploymentItem 元数据。

如何使用“驱动程序测试”模板编写驱动程序测试

通过

如何添加测试元数据

先决条件

添加测试元数据属性

反馈

其他资源

通过

如何添加测试元数据

先决条件

添加测试元数据属性

相关主题

反馈

其他资源