Illesztőprogram-ellenőrzési napló létrehozása

A Windows hardvertanúsítvány-program illesztőprogram-ellenőrzési naplót (DVL) igényel az illesztőprogramok beküldéséhez. A DVL a statikus elemzési eszközök, a CodeQL eredményeinek összegzését tartalmazza. A DVL nem tartalmaz forráskódadatokat. Mielőtt dvL-t hozna létre az illesztőprogramhoz, futtassa a CodeQL-t, a kódelemző eszközt és a statikus illesztőprogram-ellenőrzőt. További információért lásd: Static Tools Logo Test és CodeQL és a Static Tools Logo Test.

Az illesztőprogram előkészítése

  1. A kódelemzési eszközök futtatása előtt hozza létre és kapcsolja össze az illesztőprogramot a legújabb Windows Driver Kit (WDK) használatával.
  2. Válassza a Megoldáskonfiguráció kiadását és a megoldásplatform x64-es verziójának kiválasztását.

A szükséges tesztek meghatározása és futtatása

Annak megállapításához, hogy mely tesztek szükségesek a Minősíteni kívánt Windows-verzióhoz, tekintse meg a Statikus eszközök emblématesztet.

Szükség szerint futtassa az alábbi teszteket.

Az illesztőprogram-ellenőrzési napló létrehozása

  1. Az Illesztőprogram menüben válassza az Illesztőprogram-ellenőrzési napló létrehozása lehetőséget.
  2. Ellenőrizze, hogy a kódelemzési napló, a statikus illesztőprogram hitelesítő naplója és a CodeQL-naplófájlok észlelhetők-e.
  3. Válassza a Create gombot.

Az illesztőprogram-ellenőrzési napló fájlnévkiterjesztéssel rendelkezik. DVL.XML. A napló a projektmappában jön létre, például a \myDriverProject\myDriverName mappában. DVL.XML.

Az SDV elvégzi az illesztőprogram tiszta újraépítését, amely eltávolítja a kódelemzési naplót. Ezért a CA futtatása előtt mindenképpen futtassa az SDV-t.

Ha készen áll arra, hogy tesztelje az illesztőprogramot a Windows Hardware Lab Kit használatával, másolja az illesztőprogram-ellenőrzési naplót a tesztszámítógép %systemdrive%\DVL könyvtárába. Az új illesztőprogram-ellenőrzési napló másolása előtt törölje a könyvtár tartalmát a tesztszámítógépen.

Fontos

A DVL-fájl időtúllépései, kihagyások és egyéb nem sikeres eredményei elfogadhatók minősítési beküldéskor. Sikertelen eredmények nem okoznak hibát a statikus eszközök tesztjén a HLK-ban.

A Visual Studio parancssori ablakának használata

Az illesztőprogram-ellenőrzési naplót a Visual Studio parancssori ablakából is létrehozhatja. Használja a Visual Studióval telepített Visual Studio natív eszközök parancssorát, vagy az Enterprise Windows Driver Kit (EWDK) eszközt.

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

Illesztőprogram-ellenőrzési napló létrehozása az msbuild vagy a Visual Studión kívül

A Microsoft a Windows Driver Kit (WDK) és az Enterprise WDK (eWDK) részeként szállít egy dvl.exe nevű összetevőt, amely parancssoron keresztüli illesztőprogram-ellenőrzési naplók (DVL-k) létrehozására használható. A WDK/eWDK előzetes verziótól kezdve a 21342-es és újabb verzióktól kezdve létrehozhat egy DVL-t a parancssorból az msbuild vagy a Visual Studio környezetén kívül.

DVL létrehozása CodeQL sarif-fájlból

  1. Keresse meg a dvl.exe a WDK-ból vagy egy csatlakoztatott eWDK-ból. Általában a C:\Program Files (x86)\Windows Kits\10\Tools\dvl\dvl.exe telepítve van.
  2. Hívja meg a dvl.exe-t úgy, hogy megadja a /manualCreate jelzőt, az illesztőprogram nevét, a kívánt architektúrát és /sarifPath. Hol /sarifPath található a sarif fájlt tartalmazó mappa elérési útja.
"C:\Program Files (x86)\Windows Kits\10\Tools\dvl\dvl.exe" /manualCreate <driverName> <driverArchitecture> /sarifPath <pathToSarifLocation>

DVL létrehozása CodeQL sarif-fájlból vagy ca és SDV használata esetén

  1. Helyezze el egyetlen könyvtárba azokat az eredményeket, amelyek a DVL létrehozásához szükségesek, a vcxproj fájllal együtt. Az illesztőprogramok Windows-ügyfélhez való minősítéséhez ez a fájl a CodeQL SARIF-fájl. A Windows Server-tanúsítvány tartalmazhatja a Kódelemzés és a Statikus illesztőprogram-ellenőrző (SDV) eredményfájljait is. Az eszközillesztő-minősítés futtatásához szükséges eszközökről a WHCP-követelmények dokumentumaiból tájékozódhat.

  2. Helyezze a CodeQL SARIF-fájlokat és a kódelemzési XML-fájlokat a könyvtár legfelső szintjére. Helyezze az SDV DVL.xml fájlt egy sdv nevű almappába.

  3. Lépjen a parancssorból a CodeQL SARIF-fájlt tartalmazó legfelső szintű könyvtárra.

  4. Keresse meg a dvl.exe a WDK-ból vagy egy csatlakoztatott eWDK-ból.

  5. A dvl.exe funkciót hívja meg úgy, hogy átadja a /manualCreate paramétert, az illesztőprogram nevét és a kívánt architektúrát. Például:

    Használja az alábbi karakterláncok egyikét a driverArchitecture-nek:

    • X86
    • X64
    • Kar
    • Arm64

    Megjegyzés:

    Ne foglalja bele a ".sys" kifejezést az driverName karakterláncba.

  6. Ellenőrizze a DVL-t, hogy helyesen lett-e létrehozva.

Ez a használat elsősorban a CodeQL-eredményekkel rendelkező DVL-ek létrehozására szolgál, de SDV- és CA-eredményekhez is használható.

Kibocsátási megjegyzések

A Kódelemzési eszközről, a Static Driver Verifierről és az illesztőprogram-ellenőrzési naplóról a Windows Driver Kit (WDK) letöltési oldalán található WDK kibocsátási megjegyzésekben találhatók a legfrissebb információk.

  • Last updated on