Bagikan melalui

Cara membuat log verifikasi driver

  • Artikel

Program Sertifikasi Perangkat Keras Windows memerlukan log verifikasi driver (DVL) untuk pengiriman driver. DVL berisi ringkasan hasil dari alat analisis statis, CodeQL. DVL tidak berisi informasi kode sumber apa pun. Sebelum membuat DVL untuk driver Anda, jalankan CodeQL, alat analisis kode, dan pemverifikasi driver statis. Untuk informasi selengkapnya, lihat Uji Logo Alat Statis dan CodeQL dan Uji Logo Alat Statis.

Siapkan driver

  1. Sebelum menjalankan alat analisis kode, buat dan tautkan driver Anda menggunakan Windows Driver Kit (WDK) terbaru.
  2. Pilih Rilis untuk konfigurasi solusi dan x64 untuk platform solusi.

Menentukan dan menjalankan pengujian yang diperlukan

Untuk menentukan pengujian mana yang diperlukan untuk versi Windows yang ingin Anda sertifikasi, lihat Uji Logo Alat Statis.

Jalankan pengujian berikut, sesuai kebutuhan.

Membuat log verifikasi driver

  1. Dari menu Driver , pilih Buat Log Verifikasi Driver.
  2. Verifikasi bahwa file Log Analisis Kode, Log Pemverifikasi Driver Statis, dan Log CodeQL terdeteksi.
  3. Pilih Buat.

Log verifikasi driver memiliki ekstensi nama file . DVL.XML. Log dibuat di folder proyek, misalnya, \myDriverProject\myDriverName. DVL.XML.

SDV melakukan pembangunan kembali driver yang bersih, yang menghapus log Analisis Kode. Dengan demikian, pastikan untuk menjalankan SDV sebelum menjalankan CA.

Ketika Anda siap untuk menguji driver Anda menggunakan Windows Hardware Lab Kit, salin log verifikasi driver ke direktori %systemdrive%\DVL pada komputer pengujian. Hapus isi direktori pada komputer uji sebelum Anda menyalin log verifikasi driver baru.

Penting

Batas waktu, spasi, dan hasil lain yang tidak berhasil dalam file DVL dapat diterima untuk pengiriman sertifikasi. Hasil yang tidak berhasil tidak akan menyebabkan pengujian alat statis di HLK gagal.

Menggunakan jendela prompt perintah Visual Studio

Anda juga dapat membuat log verifikasi driver dari jendela prompt perintah Visual Studio. Gunakan perintah alat asli Visual Studio yang diinstal dengan Visual Studio, atau Enterprise Windows Driver Kit (EWDK).

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

Membuat log verifikasi driver di luar msbuild atau Visual Studio

Microsoft mengirimkan sebagai bagian dari Windows Driver Kit (WDK) dan Enterprise WDK (eWDK) komponen yang disebut dvl.exe yang dapat digunakan untuk menghasilkan log verifikasi driver (DLL) melalui baris perintah. Mulai pratinjau WDK/eWDK versi 21342 ke atas, dimungkinkan untuk menghasilkan DVL dari baris perintah di luar konteks msbuild atau Visual Studio.

Hasilkan DVL dari file sarif CodeQL

  1. Temukan dvl.exe dari WDK atau eWDK yang dipasang. Biasanya diinstal di C:\Program Files (x86)\Windows Kits\10\Tools\dvl\dvl.exe
  2. Panggil dvl.exe dengan meneruskan /manualCreate bendera, nama driver, arsitektur yang diinginkan, dan /sarifPath. Di mana /sarifPath menyertakan jalur ke folder yang berisi file sarif.
"C:\Program Files (x86)\Windows Kits\10\Tools\dvl\dvl.exe" /manualCreate <driverName> <driverArchitecture> /sarifPath <pathToSarifLocation>

Membuat DVL dari file sarif CodeQL, atau saat menggunakan CA dan SDV

  1. Tempatkan hasil yang harus digunakan untuk membuat DVL dalam satu direktori, bersama dengan file vcxproj apa pun. Agar driver disertifikasi untuk Klien Windows, file ini adalah file CodeQL SARIF. Sertifikasi Windows Server mungkin juga menyertakan file hasil Analisis Kode dan Pemverifikasi Driver Statis (SDV). Periksa dokumen persyaratan WHCP untuk detail spesifik tentang alat mana yang harus dijalankan untuk sertifikasi driver perangkat.

  2. Tempatkan file CodeQL SARIF dan file XML Analisis Kode di tingkat atas direktori. Tempatkan file DVL.xml SDV di subfolder yang disebut sdv.

  3. Navigasikan ke direktori tingkat atas yang berisi file CodeQL SARIF dari baris perintah.

  4. Temukan dvl.exe dari WDK atau eWDK yang dipasang.

  5. Panggil dvl.exe dengan meneruskan /manualCreate bendera, nama driver, dan arsitektur yang diinginkan. Contohnya:

    Gunakan salah satu string berikut untuk driverArchitecture Anda:

    • X86
    • X64
    • Lengan
    • Arm64

    Catatan

    Jangan sertakan ".sys" sebagai bagian dari string driverName Anda.

  6. Periksa DVL untuk memastikan bahwa DVL dihasilkan dengan benar.

Penggunaan ini terutama ditujukan untuk menghasilkan DLL dengan hasil CodeQL, tetapi juga dapat digunakan untuk hasil SDV dan CA.

Catatan rilis

Informasi terbaru tentang alat Analisis Kode, Pemverifikasi Driver Statis, dan log verifikasi driver, ada di catatan rilis WDK pada halaman unduhan Windows Driver Kit (WDK).