Aracılığıyla paylaş

Sürücü doğrulama günlüğü oluşturma

Windows Donanım Sertifikasyon Programı, sürücü gönderimleri için bir sürücü doğrulama günlüğü (DVL) gerektirir. DVL, statik analiz araçları CodeQL'den alınan sonuçların özetini içerir. DVL herhangi bir kaynak kodu bilgisi içermez. Sürücünüz için bir DVL oluşturmadan önce CodeQL' i, kod çözümleme aracını ve statik sürücü doğrulayıcısını çalıştırın. Daha fazla bilgi için bkz . Statik Araçlar Logo Testi ve CodeQL ve Statik Araçlar Logo Testi.

Sürücüyü hazırlama

  1. Kod çözümleme araçlarını çalıştırmadan önce en son Windows Driver Kit'i (WDK) kullanarak sürücünüzü derleyin ve bağlayın.
  2. Çözüm yapılandırması için Yayın ve çözüm platformu için x64 tercih edin.

Gerekli testleri belirleme ve çalıştırma

Windows sertifikalandırmak istediğiniz sürümü için hangi testlerin gerekli olduğunu belirlemek için Statik Araçlar Logo Testi bölümüne bakın.

Aşağıdaki testleri gerektiği gibi çalıştırın.

Sürücü doğrulama günlüğünü oluşturma

  1. Sürücümenüsünden Sürücü Doğrulama Günlüğü Oluştur'u seçin.
  2. Kod Çözümleme Günlüğü, Statik Sürücü Doğrulayıcı Günlüğü ve CodeQL Günlük dosyalarının algılandığını doğrulayın.
  3. Oluştur'i seçin.

Sürücü doğrulama günlüğü dosya adı uzantısına sahiptir. DVL.XML. Günlük, proje klasöründe, örneğin \myDriverProject klasöründe \myDriverName.DVL.XML olarak oluşturulur.

SDV, kod çözümleme günlüğünü kaldıran sürücünün temiz bir yeniden derlemesini gerçekleştirir. Bu nedenle, CA'yı çalıştırmadan önce SDV'yi çalıştırdığınızdan emin olun.

Windows Donanım Laboratuvar Seti'ni kullanarak sürücünüzü test etmeye hazır olduğunuzda, sürücü doğrulama günlüğünü test bilgisayarındaki %systemdrive%\DVL dizinine kopyalayın. Yeni sürücü doğrulama günlüğünü kopyalamadan önce test bilgisayarındaki dizinin içeriğini silin.

Önemli

DVL dosyasındaki zaman aşımları, boşluklar ve diğer başarılı olmayan sonuçlar sertifika gönderimi için kabul edilebilir. Başarılı olmayan sonuçlar, HLK'deki statik araçlar testinin başarısız olmasına neden olmaz.

Visual Studio komut istemi penceresini kullanma

Sürücü doğrulama günlüğünü bir Visual Studio komut istemi penceresinden de oluşturabilirsiniz. Visual Studio ile yüklenen Visual Studio yerel araçları komut istemini veya Enterprise Windows Driver Kit'i (EWDK) kullanın.

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

msbuild veya Visual Studio dışında sürücü doğrulama günlüğü oluşturma

Microsoft, komut satırı aracılığıyla sürücü doğrulama günlükleri (DVL) oluşturmak için kullanılabilecek dvl.exe adlı bir bileşen olarak Windows Driver Kit (WDK) ve Enterprise WDK (eWDK) kapsamında gelir. WDK/eWDK önizleme sürümleri 21342 ve üzeri sürümlerden başlayarak, komut satırından msbuild veya Visual Studio bağlamının dışında bir DVL oluşturmak mümkündür.

CodeQL sarif dosyasından DVL oluşturma

  1. WDK veya bağlı bir eWDK'dan dvl.exe'ı bulun. Genellikle C:\Program Files (x86)\Windows Kits\10\Tools\dvl\dvl.exe olarak kurulur.
  2. bayrağını, sürücü adını, istenen mimariyi /manualCreate ve /sarifPathgeçirerek dvl.exe çağırın. Burada /sarifPath , sarif dosyasını içeren klasörün yolunu içerir.
"C:\Program Files (x86)\Windows Kits\10\Tools\dvl\dvl.exe" /manualCreate <driverName> <driverArchitecture> /sarifPath <pathToSarifLocation>

CodeQL sarif dosyasından veya CA ve SDV kullanırken DVL oluşturma

  1. DVL'nin oluşturulması için tüketilmesi gereken sonuçları ve herhangi bir vcxproj dosyasını tek bir dizine koyun. Sürücülerin Windows İstemcisi sertifikasına sahip olması için bu dosya CodeQL SARIF dosyasıdır. Windows Server sertifikası, Kod Analizi ve Statik Sürücü Doğrulayıcı (SDV) sonuç dosyalarını da içerebilir. Cihaz sürücüsü sertifikası için hangi araçların çalıştırılması gerektiğiyle ilgili belirli ayrıntılar için WHCP gereksinimleri belgelerine bakın.

  2. CodeQL SARIF dosyalarını ve Kod Analizi XML dosyalarını dizinin en üst düzeyine yerleştirin. SDV DVL.xml dosyasını sdv adlı bir alt klasöre yerleştirin.

  3. Komut satırından CodeQL SARIF dosyasını içeren üst düzey dizine gidin.

  4. WDK veya bağlı bir eWDK üzerinden dvl.exe bul.

  5. dvl.exe'ı çağırmak için /manualCreate bayrağını, sürücü adını ve istenen mimariyi geçir. Örneğin:

    driverArchitecture'ınız için aşağıdaki dizelerden birini kullanın:

    • X86
    • X64
    • Kol
    • Arm64

    Uyarı

    driverName dizenizin bir parçası olarak ".sys" eklemeyin.

  6. DVL'nin doğru şekilde oluşturulduğundan emin olmak için DVL'yi inceleyin.

Bu kullanım öncelikli olarak CodeQL sonuçlarıyla DVL oluşturmaya yöneliktir, ancak SDV ve CA sonuçları için de kullanılabilir.

Sürüm notları

Kod Analizi aracı, Statik Sürücü Doğrulayıcı ve sürücü doğrulama günlüğü hakkındaki en güncel bilgiler, Windows Sürücü Seti (WDK) indirme sayfasındaki WDK sürüm notlarında yer alır.

  • Last updated on