Windows Device Testing Framework (WDTF)

Обзор технологии Windows Device Testing Framework (WDTF).

Для разработки Windows Device Testing Framework (WDTF) вам потребуются следующие заголовки:

• comtracing.h
• прерывание.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 Device Testing Framework (WDTF).

Перечисления

TTraceLevel Перечисление TTraceLevel определяет набор уровней для трассировки в WDTF. Значение каждого уровня зависит от параметров реестра для интерфейса ITracer.

Функции

Добавление Добавьте в коллекцию одно действие.
Добавление Добавляет одно длинное число в коллекцию.
Добавление Добавляет в коллекцию одно число.
Добавление Добавляет одну строку в коллекцию.
Добавление Добавление одного элемента в коллекцию.
Очистить Удаляет все элементы из коллекции.
Очистить Узнайте, как метод удаляет все элементы из коллекции.
Закрыть Закрывает устройство.
ConnectedStandby Переводит систему в состояние "Подключенный режим ожидания" и выходит из состояния "Подключенный режим ожидания" по истечении требуемого времени. Этот метод работает только на компьютере, поддерживающем Always On Always Connected (AOAC).
Продолжить Продолжает ввод-вывод.
ContinueAsync Асинхронно сигнализирует о продолжении ввода-вывода.
Отключить Отключает драйвер фильтра Расширенное тестирование устройств (EDT) на целевом устройстве.
Отключить Узнайте, как метод отключает драйвер фильтра 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 Узнайте, как метод get__NewEnum интерфейса IWDTFLongNumbers2 получает новую переменную итерации, которую неявно использует структура цикла For Each.
get__NewEnum Метод get__NewEnum получает новую переменную итерации, которую неявно использует структура цикла For Each.
get__NewEnum Узнайте, как метод get__NewEnum интерфейса IWDTFStrings2 получает новую переменную итерации, которую неявно использует структура цикла 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 Узнайте, как это свойство получает объект агрегирования main WDTF.
get_WDTF Это свойство получает main объекта агрегирования WDTF.
get_WDTF Этот метод получает объект агрегирования main WDTF.
get_WDTF Узнайте, как этот метод получает объект агрегирования main WDTF.
GetBits Метод GetBits возвращает набор флагов трассировки для сокласса в виде битовой маски, учитывая указанное значение TTraceLevel и ИДЕНТИФИКАТОР CLSID сокласса.
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 Записывает информационную запись в журнал тестовых случаев.
Пауза Приостанавливает ввод-вывод.
PerformIO Выполняет небольшое количество простых операций ввода-вывода на устройство.
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 Возвращает один элемент из коллекции.
ПерезагрузкаПерезапустить Перезапустите систему и текущий тест.
RebootRestartWithContext Перезагружает систему и перезапускает тестовый скрипт с контекстными данными.
Удалить Удаление действия из коллекции.
Удалить Удаляет длинное число из коллекции.
Удалить Удаляет число из коллекции.
Удалить Удаляет из коллекции строку.
Удалить Удаляет элемент из коллекции.
RemoveDevice Удаляет устройство.
RemoveDevice Узнайте, как метод удаляет устройство.
RequestEjectDevice Инициирует извлечение устройства.
RequestEjectDevice Узнайте, как метод инициирует извлечение устройства.
RescanDevice Повторно сканирует целевое устройство.
RescanDevice Узнайте, как метод повторно сканирует целевое устройство.
RescanParentDevice Выполняет повторное сканирование и повторное перечисление родительского устройства целевого устройства.
RescanParentDevice Узнайте, как метод повторно сканирует и перечисляет родительское устройство целевого устройства.
RestartDevice Инициирует перезагрузку устройства.
RestartDevice Узнайте, как метод инициирует перезагрузку устройства.
SetSimulatedBatteryChargePercentage Задает процент заряда, передаваемый операционной системе имитированной батареей.
SetSimulatedBatteryToAC Устанавливает для имитированного состояния батареи значение переменного тока.
SetSimulatedBatteryToDC Устанавливает состояние имитированной батареи в положение питание постоянного тока.
SetTarget Метод SetTarget используется внутри WDTF. Не вызывайте этот метод напрямую.
SetTraceLevel Метод SetTraceLevel задает уровень трассировки для объекта .
Sleep Переводит систему в требуемое состояние спящего режима.
Запуск Узнайте, как метод открывает устройство.
StartAsync Асинхронно сигнализирует о возникновении события запуска.
StartTestCase Отмечает начало тестового случая.
Остановить Останавливает устройство.
StopAsync Асинхронно сигнализирует о возникновении события остановки.
WaitAsyncCompletion Ожидает завершения любого из асинхронных событий.

Интерфейсы

IAction Интерфейсы IAction — это подключаемые модули, которые могут управлять экземпляром интерфейса IWDTFTarget2.
ITracer Интерфейс ITracer позволяет отдельным экземплярам каждого интерфейса WDTF определять конкретные параметры трассировки для заданного совместного класса реализации. Эти параметры записываются в реестр.
ITracing Интерфейс ITracing задает значение TTraceLevel объекта. Этот интерфейс является базовым для большинства интерфейсов WDTF.
IWDTF2 Определяет свойства для коллекции WDTF.
IWDTFAction2 Определяет операции и свойства, которые могут управлять экземпляром интерфейса IWDTFTarget2.
IWDTFActions2 Определяет операции и свойства для коллекции действий, возвращаемых методом IWDTFTargets::GetInterfaces.
IWDTFCONFIG2 Определяет операции, управляющие объектами WDTF в тестовом скрипте.
IWDTFDeviceDepot2 Определяет свойства и операции для коллекции устройств на компьютере.
IWDTFEnhancedDeviceTestSupportAction2 Определяет операции и свойства, поддерживающие драйвер фильтра расширенного тестирования устройств (EDT).
IWDTFEnhancedDeviceTestSupportActions2 Определяет операции и свойства, поддерживающие коллекцию действий расширенного тестирования устройств (EDT).
IWDTFLOG2 Определяет операции, позволяющие автору тестового случая добавлять в журнал тестов WDTF.
IWDTFLongNumbers2 Определяет операции и свойства для коллекции длинных чисел.
IWDTFNumbers2 Определяет операции и свойства для коллекции чисел.
IWDTFPNPAction2 Определяет операции и свойства для тестовых интерфейсов, связанных с устройством Plug and Play (PNP).
IWDTFPNPActions2 Определяет операции и свойства для коллекции тестовых интерфейсов, связанных с устройством Plug and Play (PNP).
IWDTFSimpleIOEx2 Определяет операции для простого синхронного теста функциональности ввода-вывода.
IWDTFSimpleIOStressAction2 Определяет операции для простого асинхронного теста функциональности ввода-вывода.
IWDTFSimpleIOStressActions2 Определяет операции для коллекции простых асинхронных тестов функциональных возможностей ввода-вывода.
IWDTFSimulatedBatterySystemAction Интерфейс IWDTFSimulatedBatterySystemAction
IWDTFStrings2 Определяет операции и свойства для коллекции строк.
IWDTFSystemAction2 Определяет операции и свойства, поддерживающие тестирование драйверов.
IWDTFSystemDepot2 Определяет операции и свойства для SystemDepot — объекта, представляющего локальный компьютер.
IWDTFTarget2 Определяет операции и свойства для проверяемого элемента.
IWDTFTargets2 Определяет свойства и операции для коллекции.