Библиотека среды выполнения WDTF
Библиотека среды выполнения WDTF доступна в составе пакета драйверов Windows (WDK). При установке WDK также устанавливается Платформа тестирования драйверов Windows (WDTF). Шаблоны и примеры файлов для тестирования и разработки устанавливаются вместе с WDK. Библиотека среды выполнения WDTF должна быть установлена в любой системе, в которой требуется выполнять тесты на основе WDTF. Сюда входят тесты, предоставляемые в WDK, и тесты, которые вы создаете с помощью шаблонов тестов WDK.
WDK также включает отдельный пакет установки (*.msi), который можно использовать для установки среды выполнения WDTF на тестовом компьютере. MSI выполняет следующие действия:
Копирует файлы.
Добавляет разделы реестра.
Регистрирует объекты WDTF.
Установка и удаление файла журнала.
Библиотека среды выполнения WDTF включает средства для рассмотрения и выполнения тестов.
| Имя средства или скрипта команды | Описание |
|---|---|
| CheckWDTFInstall.cmd | Проверяет, правильно ли установлен WDTF. При выполнении этой команды создается файл CheckWDTFInstall.log, содержащий сведения обо всех установленных компонентах WDTF. |
| DisplayDeviceClass.vbs | Отображает сведения о классе устройства, существующие в текущей системе. Отображаются guid класса и понятное имя класса. Полезно при попытке создать запросы /DQ, которые ищут определенные классы устройств. |
| DisplayDeviceDataFields.cmd | Отображает сведения о классе устройства, существующие в текущей системе. Отображаются guid класса и понятное имя класса. Полезно при попытке создать запросы /DQ, которые ищут определенные классы устройств. |
| DisplayDevices.vbs | Отображает сведения о каждом устройстве, выраженные параметром /DQ. По умолчанию используется все устройства в системе. |
| DisplayDevicesWithWDTFilters.vbs | Отображает любое устройство, на котором установлен один из драйверов фильтров WDTF. В WDTF есть три драйвера фильтров: EDT, IOSPY или драйвер кнопки. |
| DisplayDeviceTree.vbs | Отображает дерево устройств текущей системы. |
| DisplaySystemDataFields.cmd | Отображает все системные пространства имен и имеющиеся у них поля. |
Установка библиотеки среды выполнения WDTF
При настройке тестового компьютера для развертывания на тестовом компьютере устанавливается библиотека среды выполнения WDTF. Следуйте инструкциям в статье Подготовка компьютера для развертывания и тестирования драйверов (WDK 10 и WDK 8.1).
Вы также можете установить библиотеку среды выполнения WDTF вручную.
Установка WDTF на тестовом компьютере (предпочтительный метод)
Установите Visual Studio, а затем установите WDK.
Настройка удаленного компьютера для тестирования. В Visual Studio выберите меню Драйвер , наведите указатель на пункт Тест, а затем выберите Настройка компьютеров.
Установка WDTF вручную на тестовом компьютере (альтернативный метод)
Установите Visual Studio и WDK на компьютере, который используется для разработки.
Скопируйте файлы установки WDTF с компьютера, на котором установлен WDK, на тестовый компьютер. Файлы установки WDTF (*.msi и *.cab файлы) находятся в каталоге %programfiles%\Windows Kits\10\Testing\Runtimes в системе разработки. Скопируйте все файлы в каталоге, который соответствует архитектуре тестового компьютера.
На тестовом компьютере откройте окно командной строки с повышенными правами (запуск от имени администратора) и перейдите в каталог, содержащий файлы установки WDTF. Выполните следующую команду, чтобы установить WDTF.
msiexec /i "OneCoreUap_WDTF_Desktop_Kit_Content-x64_en-us.msi"
msiexec /i "WDTF_Desktop_Kit_Product-x64_en-us.msi"
-Или-
msiexec /i "OneCoreUap_WDTF_Desktop_Kit_Content-x86_en-us.msi"
msiexec /i "WDTF_Desktop_Kit_Product-x86_en-us.msi"
В следующей таблице описаны параметры, которые можно использовать с командой msiexec .
| Параметр | Описание |
|---|---|
| /L* Имени файла | Записывает все сообщения и ошибки в файл с именем файла. |
| WDTFDIR=CustomInstallationDirectory | Указывает целевой каталог для сред выполнения WDTF. WDTFDir по умолчанию — %programfiles%\Windows Kits\10\Testing\Runtimes\WDTF |
| WDTF_SKIP_MACHINE_CONFIG=[1 | 2] | Укажите значение 1 , чтобы пропустить настройку cscript.exe в качестве обработчика скриптов по умолчанию. Укажите значение 2 , чтобы пропустить включение пробуждения ac и DC RTC. |
| /? | Отображает справку по параметрам msiexec.exe. |
Пример
msiexec /i "OneCoreUap_WDTF_Desktop_Kit_Content-x64_en-us.msi" /l* OneCoreUap_WDTFInstall.log WDTFDir=c:\wdtf WDTF_SKIP_MACHINE_CONFIG=1
msiexec /i "WDTF_Desktop_Kit_Product-x64_en-us.msi" /l* WDTFInstall.log WDTFDir=c:\wdtf WDTF_SKIP_MACHINE_CONFIG=1
Как определить, установлена ли на компьютере библиотека среды выполнения WDTF
Вы можете проверить правильность установки WDTF, выполнив на тестовом компьютере командный скрипт. При выполнении этой команды создается файл CheckWDTFInstall.log, содержащий сведения обо всех установленных компонентах WDTF.
Откройте окно командной строки на тестовом компьютере.
Выполните команду
%WDTFDir%\Tools\CheckWDTFInstall.cmd.Откройте файл журнала CheckWDTFInstall.log и проверьте результаты.
Удаление библиотеки среды выполнения WDTF
При настройке тестового компьютера для развертывания, следуя инструкциям По подготовке компьютера для развертывания и тестирования драйверов (WDK 10), библиотека среды выполнения WDTF устанавливается на целевом компьютере.
Вы можете удалить библиотеку среды выполнения WDTF, удалив подготовку с целевого компьютера. Дополнительные сведения см. в разделе Удаление подготовки с целевого компьютера.
Вы также можете удалить библиотеку среды выполнения WDTF вручную.
Удаление WDTF вручную на тестовом компьютере
На тестовом компьютере перейдите в раздел Параметры и выберите Приложения.
В разделе Программы и компоненты найдите библиотеки среды выполнения Платформы тестирования драйверов Windows (WDTF), выберите и удерживайте (или щелкните правой кнопкой мыши) и выберите Удалить.