Поделиться через

Создание журнала проверки драйвера

  • Статья

Программа сертификации оборудования Windows требует журнал проверки драйвера (DVL) для отправки драйверов. DVL может содержать сводку результатов анализа кода (ЦС), средства проверки статических драйверов (SDV) и CodeQL. DVL не содержит никаких сведений о исходном коде. Необходимо запустить CodeQL, средство анализа кода и средство проверки статических драйверов, прежде чем создавать DVL для драйвера. Дополнительные сведения см. в разделе "Статические средства" и "КодQL" и "Статические средства"

Создание журнала проверки драйвера

Подготовка драйвера

  1. Перед запуском средств анализа кода убедитесь, что вы можете создать и связать драйвер с помощью последней версии комплекта драйверов Windows (WDK).
  2. Для решения драйвера убедитесь, что вы выбрали конфигурацию выпуска в качестве конфигурации решения и x64 в качестве платформы решения.

Определение и запуск необходимых тестов

  1. Ознакомьтесь со статическими средствами, чтобы определить, какие тесты необходимы для версии Windows, для которой вы хотите сертифицировать.

Выполните следующие тесты по мере необходимости.

Создание журнала проверки драйвера

  1. Создайте журнал проверки драйвера. В меню "Драйвер" выберите "Создать журнал проверки драйвера...".

  2. Убедитесь, что обнаружены журнал анализа кода, журнал проверки статических драйверов и файлы журнала CodeQL. Нажмите кнопку создания.

Журнал проверки драйвера имеет расширение имени файла. DVL.XML. Журнал создается в папке проекта, например \myDriverProject\myDriverName. DVL.XML.

Примечание SDV выполняет чистое перестроение драйвера, которое удаляет журнал анализа кода. Таким образом, перед запуском ЦС обязательно запустите SDV.

Обратите внимание , что когда вы готовы протестировать драйвер с помощью комплекта лабораторий оборудования Windows, необходимо скопировать журнал проверки драйвера в каталог %systemdrive%\DVL на тестовом компьютере. Перед копированием нового журнала проверки драйвера необходимо удалить содержимое каталога на тестовом компьютере.

Замечания

Последние сведения о средстве анализа кода, средстве проверки статических драйверов и журнале проверки драйверов см. в заметках о выпуске WDK. Заметки о выпуске доступны на странице скачивания пакета драйверов Windows (WDK).

Внимание

Время ожидания, пробелы и другие неисчислимые результаты в DVL-файле допустимы для отправки сертификации. Это не приведет к сбою теста статических средств в HLK.

Окно командной строки Visual Studio

Вы также можете создать журнал проверки драйвера из окна командной строки Visual Studio с помощью командной строки Visual Studio Native Tools, установленной с помощью Visual Studio, или с помощью пакета драйверов Enterprise Windows (EWDK).

msbuild.exe <vcxprojectfile> /target:dvl /p:Configuration="Release" /P:Platform=x64

Создание журнала проверки драйвера за пределами msbuild или Visual Studio

Корпорация Майкрософт поставляется в составе комплекта драйверов Windows (WDK) и Enterprise WDK (eWDK) компонент с именем dvl.exe который можно использовать для создания журналов проверки драйвера (DVLS) с помощью командной строки. Начиная с предварительной версии WDK/eWDK версии 21342 и выше, можно создать DVL из командной строки вне контекста msbuild или Visual Studio. Выполните следующие действия, чтобы создать DVL с помощью командной строки:

  1. Поместите результаты, которые необходимо использовать для создания DVL в одном каталоге, а также любого файла vcxproj. Как правило, для драйверов, предназначенных для сертификации клиента Windows, это файл CodeQL SARIF. Для сертификации Windows Server это также может включать файлы результатов анализа кода и статического средства проверки драйверов (SDV). Ознакомьтесь с документами о требованиях WHCP для получения конкретных сведений о том, какие средства должны выполняться для сертификации драйверов устройств.
  2. Файлы CodeQL SARIF и XML-файлы анализа кода должны размещаться на верхнем уровне каталога. Файл SDV DVL.xml должен быть помещен в вложенную папку SDV.
  3. В командной строке перейдите в каталог верхнего уровня, содержащий файл CodeQL SARIF.
  4. Найдите dvl.exe из WDK или подключенного eWDK.
  5. Вызов dvl.exe путем передачи флага /manualCreate, имени драйвера и требуемой архитектуры. Например:
"C:\Program Files (x86)\Windows Kits\10\Tools\dvl\dvl.exe" /manualCreate <driverName> <driverArchitecture>

Для строки driverArchitecture следует использовать одну из следующих строк:

  • X86
  • X64
  • Arm
  • Arm64

Не включать ".sys" в строку driverName

  1. Проверьте созданный DVL, чтобы убедиться, что он был создан правильно

Это использование в основном предназначено для создания DVLs с результатами CodeQL, но также может использоваться для результатов SDV и ЦС.