Windows 设备测试框架 (WDTF)

Windows 设备测试框架 (WDTF) 技术概述。

若要 (WDTF) 开发 Windows 设备测试框架，需要以下标头：

• comtracing.h
• interruption.h
• itestresource.h
• logcontext.h
• logcontroller.h
• logtestresults.h
• preservelasterror.h
• resourcelist.h
• runtimeparameters.h
• screencapture.h
• te.common.h
• testdata.h
• testnotification.h
• throw.h
• tracing.h
• verify.h
• wdtf.h
• wdtfedtaction.h
• wdtfinterfaces.h
• wdtfinterfacessup.h
• wdtflogging.h
• wdtfpnpaction.h
• wdtfsimulatedbatterysystemaction.h
• wdtfsystemaction.h
• wex.common.h
• wex.logger.h
• wexassert.h
• wexdebug.h
• wexexception.h
• wexlogtrace.h
• wexstring.h
• wextestclass.h
• wextypes.h
• wppdefs.h

有关编程指南，请参阅 Windows 设备测试框架 (WDTF) 。

枚举

TTraceLevel TTraceLevel 枚举为 WDTF 中的跟踪定义一组级别。 每个级别的含义取决于 ITracer 接口的注册表设置。

函数

添加 将单个操作添加到集合。
添加 将单个长数字添加到集合中。
添加 将单个数字添加到集合。
添加 将单个字符串添加到集合。
添加 将单个项添加到集合。
Clear 从集合中移除所有项。
Clear 了解 方法如何从集合中删除所有项。
关闭 关闭设备。
ConnectedStandby 将系统置于连接待机状态，并在所需时间过后退出连接待机状态。 此方法仅适用于支持 Always On Always Connected (AOAC) 的计算机。
继续 继续 I/O。
ContinueAsync 异步向 I/O 发出信号以继续。
Disable 在目标设备上禁用增强型设备测试 (EDT) 筛选器驱动程序。
Disable 了解 方法如何在目标设备上禁用增强型设备测试 (EDT) 筛选器驱动程序。
DisableDevice 禁用目标设备。
DisableDevice 了解 方法如何禁用目标设备。
DisableObjectErrorLogging 禁用操作的对象错误日志记录。
DisableObjectErrorLogging 禁用集合中所有操作的对象错误日志记录。
DisableObjectErrorLogging 为所有对象禁用对象错误日志记录。
DisableObjectLogging 禁用操作的对象日志记录。
DisableObjectLogging 禁用集合中所有操作的对象日志记录。
DisableObjectLogging 禁用所有对象的对象日志记录。
DisableRealBatteries 如果系统中存在实际电池，则禁用它们。
DisableSimulatedBattery 禁用模拟电池。
EDTCancelRemoveDevice 将IRP_MN_CANCEL_REMOVE_DEVICE事件发送到目标设备。
EDTCancelRemoveDevice 了解 方法如何将IRP_MN_CANCEL_REMOVE_DEVICE事件发送到目标设备。
EDTCancelStopDevice 将IRP_MN_CANCEL_STOP_DEVICE事件发送到目标设备。
EDTCancelStopDevice 了解 方法如何将IRP_MN_CANCEL_STOP_DEVICE事件发送到目标设备。
EDTSurpriseRemoveDevice 将IRP_MN_SURPRISE_REMOVAL事件发送到目标设备。
EDTSurpriseRemoveDevice 了解 方法如何将IRP_MN_SURPRISE_REMOVAL事件发送到目标设备。
EDTTryStopDevice 尝试将IRP_MN_STOP_DEVICE事件发送到目标设备。
EDTTryStopDevice 了解 方法如何尝试将IRP_MN_STOP_DEVICE事件发送到目标设备。
EDTTryStopDeviceFailRestart 此方法尝试将IRP_MN_STOP_DEVICE事件发送到目标设备，然后在后续设备重启时失败。
EDTTryStopDeviceFailRestart 了解 EDTTryStopDeviceFailRestart 方法如何尝试向目标设备发送IRP_MN_STOP_DEVICE事件，然后使后续设备重启失败。
EDTTryStopDeviceRequestNewResources 尝试将IRP_MN_STOP_DEVICE事件发送到目标设备，并将新资源分配给目标设备。
EDTTryStopDeviceRequestNewResources 了解 方法如何尝试将IRP_MN_STOP_DEVICE事件发送到目标设备并将新资源分配给目标设备。
启用 在目标设备上启用增强的设备测试 (EDT) 筛选器驱动程序。
启用 了解 方法如何在目标设备上启用增强的设备测试 (EDT) 筛选器驱动程序。
EnableDevice 启用目标设备。
EnableDevice 了解 方法如何启用目标设备。
EnableObjectErrorLogging 为操作启用对象错误日志记录。
EnableObjectErrorLogging 为集合中的所有操作启用对象错误日志记录。
EnableObjectErrorLogging 为所有对象启用对象错误日志记录。
EnableObjectLogging 为操作启用对象日志记录。
EnableObjectLogging 为集合中的所有操作启用对象日志记录。
EnableObjectLogging 为所有对象启用对象日志记录。
EnableRealBatteries 如果系统中存在真正的电池，则启用这些电池。
EnableSimulatedBattery 启用模拟电池。
EndTestCase 标记测试用例的结束。
Eval 评估此目标是否与 SDEL 语句匹配。
Eval 评估集合中的所有项是否与 SDEL 语句匹配。
get__NewEnum 获取 For Each 循环结构隐式使用的新迭代变量。
get__NewEnum 了解此 IWDTFDeviceDepot2 接口方法如何获取 For Each 循环结构隐式使用的新迭代变量。
get__NewEnum 了解 IWDTFLongNumbers2 接口的 get__NewEnum 方法如何获取 For Each 循环结构隐式使用的新迭代变量。
get__NewEnum get__NewEnum 方法获取 For Each 循环结构隐式使用的新迭代变量。
get__NewEnum 了解 IWDTFStrings2 接口的 get__NewEnum 方法如何获取 For Each 循环结构隐式使用的新迭代变量。
get__NewEnum 了解此 IWDTFTargets2 接口方法如何获取 For Each 循环结构隐式使用的新迭代变量。
get_Config 获取 WDTF 配置对象。
get_Context 获取并设置表示目标的用户数据的名称/值对。
get_Count 获取此集合中的操作数。
get_Count 获取 DeviceDepot 当前提供的设备数。
get_Count 获取集合中长数字的数目。
get_Count 获取集合中的数字数。
get_Count 获取集合中的字符串数目。
get_Count 获取此集合中的项数。
get_Critical 获取或设置一个值，该值指示系统电源状态是否严重。
get_DeviceDepot 获取 DeviceDepot 对象。
get_IsRestarted 获取一个值，该值指示测试脚本是否由于调用 RebootRestart 或 RebootRestartWithContext 而重新启动。
get_Item 获取集合中的单个操作。
get_Item 获取 DeviceDepot 中的单个设备。
get_Item 获取集合中的单个长号。
get_Item 获取集合中的单个数字。
get_Item 获取集合中的单个字符串。
get_Item 获取集合中的单个项。
get_Log 获取 WDTF 日志对象。
get_RootDevice 获取根设备。
get_SleepWakeTimeInSeconds 获取或设置系统从睡眠状态唤醒的时间（以秒为单位）。
get_SystemDepot 获取 SystemDepot 对象。
get_Target 获取此操作所引用的目标。
get_ThisSystem 获取表示本地计算机的 IWDTFTarget2 值。
get_Type 获取一个值，该值标识目标来自的仓库。
get_WDTF 了解此属性如何获取 WDTF 聚合对象的main。
get_WDTF 此属性获取main WDTF 聚合对象。
get_WDTF 此方法获取main WDTF 聚合对象。
get_WDTF 了解此方法如何获取main WDTF 聚合对象。
GetBits 给定指定的 TTraceLevel 值和 coclass 的 CLSID，GetBits 方法将 coclass 的跟踪标志集作为位掩码返回。
GetFirstSleepState 返回第一个支持的睡眠状态。
GetInterface 返回目标的操作。
GetInterfaces 返回支持 接口的操作集合 - 对于每个具有接口的项，一个 IWDTFAction2。
GetInterfacesIfExist 了解方法如何返回支持 接口的操作集合 - 每个具有接口的项一个 IWDTFAction2。
GetNextSleepState 返回下一个支持的睡眠状态。
GetRelations 返回相关目标的集合。
GetStatus 返回最后一个操作的状态代码。
GetStatusString 以字符串的形式返回上一个操作的状态。
GetValue 从目标返回一个值，该值与指定属性相关联。
GetValueBool 从与指定属性关联的目标返回布尔值。
GetValueLongNumber 从与指定属性关联的目标中返回一个长数字值。
GetValueLongNumbers 从目标返回与指定属性关联的长数字值的集合。
GetValueNumber 从与指定属性关联的目标中返回一个数字值。
GetValueNumbers 从目标返回与指定属性关联的数字值的集合。
GetValueString 从目标返回与指定属性关联的字符串值。
GetValueStrings 返回目标中与指定属性关联的字符串值的集合。
HasContext 确定目标是否存在给定上下文。
HasInterface 确定目标是否支持给定接口。
IsEnabled 获取一个值，该值指示是否在目标设备上启用增强型设备测试 (EDT) 筛选器驱动程序。
IsEnabled 了解 方法如何获取一个值，该值指示是否在目标设备上启用增强型设备测试 (EDT) 筛选器驱动程序。
IsRebootRequired 获取一个值，该值指示增强型设备测试 (EDT) 筛选器驱动程序是否需要重新启动。
IsRebootRequired 了解 方法如何获取一个值，该值指示增强型设备测试 (EDT) 筛选器驱动程序是否需要重新启动。
IsRestartedWithContext 获取一个值，该值指示是否针对特定上下文重启了测试脚本。
IsStatusSuccess 获取一个值，该值指示上次操作是否成功。
打开 打开设备。
OutputError 将错误条目写入测试用例日志。
OutputInfo 将信息性条目写入测试用例日志。
暂停 暂停 I/O。
PerformIO 对设备执行少量的简单 I/O。
PowerAnalyzeTraceByFile 分析已收集并存储在关联跟踪消息 (.etl) 日志文件中的电源跟踪会话。 此方法仅适用于 Windows 8 及更高版本。
PowerTracingEnd 此方法结束电源跟踪会话。
PowerTracingStart 启动电源状态转换的跟踪会话，并将跟踪消息文件 (Wdtfpwr.etl) 保存在当前工作目录中。 此方法从 Windows 8 开始可用。
PowerTracingStartByFile 启动电源状态转换的跟踪会话，并使用指定路径将跟踪消息文件保存 (.etl) 。 此方法从 Windows 8 开始可用。
put_Context 了解 方法如何获取和设置表示目标用户数据的名称/值对。
put_Critical 设置或获取一个值，该值指示系统电源状态是否严重。
put_SkipRestart 设置一个值，该值指示默认情况下是否应重启目标设备。
put_SkipRestart 了解 方法如何设置一个值，该值指示默认情况下是否应重启目标设备。
put_SleepWakeTimeInSeconds 设置或获取系统从睡眠状态唤醒的时间（以秒为单位）。
查询 返回 DeviceDepot 中设备的子集。
查询 返回集合中项的子集。
QuerySingle 从 DeviceDepot 返回单个目标设备。
QuerySingle 从集合中返回单个项。
RebootRestart 重启系统和当前测试。
RebootRestartWithContext 重新启动系统并使用上下文数据重启测试脚本。
移除 从集合中删除操作。
移除 从集合中删除长数字。
移除 从集合中删除数字。
移除 从集合中移除字符串。
移除 从集合中删除某一项。
RemoveDevice 删除设备。
RemoveDevice 了解 方法如何删除设备。
RequestEjectDevice 启动设备弹出。
RequestEjectDevice 了解方法如何启动设备弹出。
RescanDevice 重新扫描目标设备。
RescanDevice 了解 方法如何重新扫描目标设备。
RescanParentDevice 重新扫描并重新枚举目标设备的父设备。
RescanParentDevice 了解 方法如何重新扫描和重新枚举目标设备的父设备。
RestartDevice 启动设备重启。
RestartDevice 了解 方法如何启动设备重启。
SetSimulatedBatteryChargePercentage 设置模拟电池向 OS 报告的充电百分比。
SetSimulatedBatteryToAC 将模拟电池状态设置为交流电源。
SetSimulatedBatteryToDC 将模拟电池状态设置为 DC 电源。
SetTarget SetTarget 方法由 WDTF 在内部使用。 请勿直接调用此方法。
SetTraceLevel SetTraceLevel 方法设置对象的跟踪级别。
休眠 使系统进入所需的睡眠状态。
启动 了解 方法如何打开设备。
StartAsync 以异步方式发出开始事件的信号。
StartTestCase 标记测试用例的开始。
停止 停止设备。
StopAsync 异步指示停止事件发生。
WaitAsyncCompletion 等待任何异步事件完成。

接口

IAction IAction 接口是可以控制 IWDTFTarget2 接口实例的插件。
Itracer ITracer 接口使每个 WDTF 接口的单个实例能够确定给定实现 coclass 的特定跟踪设置。 这些设置记录在注册表中。
ITracing ITracing 接口设置对象的 TTraceLevel 值。 此接口是大多数 WDTF 接口的基接口。
IWDTF2 定义 WDTF 集合的属性。
IWDTFAction2 定义可控制 IWDTFTarget2 接口实例的操作和属性。
IWDTFActions2 定义 IWDTFTargets：：GetInterfaces 方法返回的操作集合的操作和属性。
IWDTFCONFIG2 定义控制测试脚本中的 WDTF 对象的操作。
IWDTFDeviceDepot2 定义计算机上设备集合的属性和操作。
IWDTFEnhancedDeviceTestSupportAction2 定义支持增强型设备测试 (EDT) 筛选器驱动程序的操作和属性。
IWDTFEnhancedDeviceTestSupportActions2 定义支持增强型设备测试 (EDT) 操作集合的操作和属性。
IWDTFLOG2 定义使测试用例作者能够添加到 WDTF 测试日志的操作。
IWDTFLongNumbers2 定义长数字集合的操作和属性。
IWDTFNumbers2 定义数字集合的操作和属性。
IWDTFPNPAction2 定义即插即用 (PNP) 设备相关测试接口的操作和属性。
IWDTFPNPActions2 定义即插即用 (PNP) 设备相关测试接口集合的操作和属性。
IWDTFSimpleIOEx2 定义简单同步 I/O 功能测试的操作。
IWDTFSimpleIOStressAction2 定义简单的异步 I/O 功能测试的操作。
IWDTFSimpleIOStressActions2 定义简单异步 I/O 功能测试集合的操作。
IWDTFSimulatedBatterySystemAction IWDTFSimulatedBatterySystemAction 接口
IWDTFStrings2 定义字符串集合的操作和属性。
IWDTFSystemAction2 定义支持驱动程序测试的操作和属性。
IWDTFSystemDepot2 定义 SystemDepot 的操作和属性 - 表示本地计算机的对象。
IWDTFTarget2 定义可测试项的操作和属性。
IWDTFTargets2 定义集合的属性和操作。