Включение внедрения ошибок

Средство WdfTester предоставляет интерфейс WMI для настройки инъекции ошибок DDI для определённого драйвера. Предоставлен сценарий (WdftesterScript.wsf), использующий этот интерфейс WMI для настройки внедрения ошибок. Вы можете написать собственный скрипт или использовать предоставленный скрипт для инъекции ошибок. Скрипт (WdftesterScript.wsf) можно запустить из окна командной строки, чтобы зарегистрировать, настроить и отменить регистрацию драйвера. Скрипт также имеет параметр командной строки с именем runtest.

Что делает параметр runtest

Параметр runtest выполняет простые операции отключения и включения операций с драйвером. В этом параметре показано, как использовать средство. Сначала скрипт отключает указанный драйвер, а затем включает его. Это позволяет WdfTester отслеживать все вызовы DDI, выполненные во время отключения и включения операций. Скрипт использует один из интерфейсов WMI для получения списка DDI, вызванных в течение этого периода. Сценарий определяет, какие из этих DDIs могут быть неисправными (только те, которые возвращают NTSTATUS). Затем скрипт вызывает другой интерфейс WMI, чтобы настроить WdfTester на сбой первого DDI в списке. Скрипт отключает и включает драйвер, который приводит к сбою DDI и срабатыванию события WMI. Скрипт уже ожидает события сбоя WMI для DDI. Если событие получено успешно, и сбой не привел к тому, что компьютер не будет отвечать или вызвать проверку ошибок (как определено разработчиком драйвера или тестировщиком), тест считается успешным. Затем скрипт повторяет эти шаги для следующего DDI в списке.

Заметка Для параметра runtest необходимо скопировать средство DevCon (Devcon.exe) и поместить его в тот же каталог, что и другие файлы Wdftester. Приложение Devcon.exe находится в каталоге %WDKRoot%\tools\<platform> .

Опция «runtest»:

1. Регистрирует драйвер в WdfTester. Если драйвер не установлен, его необходимо установить перед использованием runtest.

2. Включает средство проверки драйверов для этого драйвера (компьютеры под управлением Windows Vista или более поздней версии не требуют перезагрузки).

3. Отключает драйвер с помощью приложения Devcon.

4. Включает драйвер с помощью приложения Devcon.

5. Извлекает имена функций, которые были вызваны во время операций включения и отключения, идентифицирует эти функции, возвращающие NTSTATUS и которые могут быть неудачными.

6. Запускает асинхронную систему уведомления о событиях WMI.

7. Для каждого DDI, который может быть неудачным из списка, полученного на шаге 5:

   1. Настраивает функцию для обработки сбоев.
   2. Отключает и включает драйвер с помощью Devcon.exe. Эта операция вызывает функцию, и WdfTester не выполняет вызов функции успешно.
   3. Ожидает срабатывания события WMI.
   4. Если событие WMI запускается, параметр runtest повторяет шаг 7 для следующей функции в списке.

8. Отменяет регистрацию драйвера.