Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
A keretrendszer beépített ellenőrzési funkciókat biztosít, amelyekkel tesztelheti a futó User-Mode Illesztőprogram-keretrendszer (UMDF) illesztőprogramját. Ez a funkció, más néven UMDF Verifier, széles körben ellenőrzi az illesztőprogram állapotát és azokat az argumentumokat, amelyeket az illesztőprogram átad a keretrendszer objektummetódusainak. Az UMDF Verifiert használhatja önállóan vagy az általános célú Application Verifier (AppVerif.exe) eszközzel együtt.
Az UMDF Verifier ellenőrzi a zárolási beszerzéseket és a hierarchiákat, ellenőrzi a megfelelő I/O-lemondást és az üzenetsor-használatot, és biztosítja, hogy az illesztőprogram és a keretrendszer kövesse a dokumentált szerződéseket.
Az UMDF Verifier hibát okoz az UMDF illesztőprogram-kódjában a gazdagép folyamatának hibaellenőrzéséhez . Az UMDF-hibaellenőrzés azonban nem okoz kék szöveges képernyőt a hibával kapcsolatos információkkal. Ehelyett egy UMDF-hibaellenőrzés:
Létrehoz egy memóriaképfájlt, és menti a fájlt a számítógép naplófájlkönyvtárába (például %windir%\System32\LogFiles\WUDF\Xxx.dmp).
Jegyzet Az UMDF 2.15-től kezdve a naplókönyvtár %ProgramData%\Microsoft\WDF.
Hibajelentést hoz létre a Microsoft számára (opt-in).
Betörik a hibakeresőbe, ha a számítógéphez van csatlakoztatva.
Leállítja a gazdafolyamatot, és letiltja az eszközt.
Az UMDF 2.0-tól kezdődően az UMDF Verifier bizonyos esetekben problémákat okoz a töréspontokon, és más esetekben UMDF-hibaellenőrzést okoz. Ez a viselkedés hasonló a KMDF Verifieréhez.
Határozottan javasoljuk, hogy az illesztőprogram fejlesztése és tesztelése az Application Verifier (AppVerif.exe) engedélyezése után WUDFHost.exe. Használja a következő parancsot, csatoljon egy hibakeresőt, majd indítsa újra.
AppVerif -enable Heaps Exceptions Handles Locks Memory TLS Leak -for WudfHost.exe
Az UMDF 2.0-s verziójától kezdve, ha az Application Verifiert futtatja az illesztőprogram-gazdafolyamaton (Wudfhost), az UMDF Verifier automatikusan engedélyeződik az adott gazdagépben lévő összes UMDF 2.0 illesztőprogramhoz, valamint az összes jövőbeli illesztőprogram-gazdagép-folyamatokban lévő UMDF 2.0 illesztőprogramhoz.
Az UMDF 1.11 és korábbi verzióiban a keretrendszer hitelesítője mindig be van kapcsolva, és nem kapcsolhatja ki.
Az UMDF Verifier engedélyezése és letiltása
Az UMDF Verifier manuális engedélyezéséhez állítsa a VerifierOn értéket nullától eltérő értékre a HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\WUDF\Services\<illesztőprogram-név> beállításkulcsának Parameters\Wdf alkulcsában.
Jegyzet A VerifierOn-érték megléte, akár nulla értékre is állítva, felülírja az Application Verifierrel való kapcsolatot. Ennek eredményeképpen azt javasoljuk, hogy törölje az értéket, ha nem kényszeríti rá, ahelyett, hogy nullára állítja.
Annak megállapításához, hogy az UMDF Verifier engedélyezve van-e, állítson be egy töréspontot egy helyen, miután az illesztőprogram meghívja a WdfDriverCreate-ot , és használja a !wdfdriverinfo hibakereső bővítmény parancsot:
!wdfkd.wdfdriverinfo<az illesztőprogram nevét> **** 0x1
További információ a hibakereső bővítményparancsokról: Hibakereső bővítmények keretrendszeralapú illesztőprogramokhoz.
A hitelesítő viselkedésének szabályozása
Az UMDF Verifier viselkedését a beállításjegyzék értékeinek módosításával szabályozhatja. Másik lehetőségként a WDF Verifier vezérlőalkalmazás használatával is beállíthatja ezeket az értékeket.
A következő beállításjegyzék-értékek használhatók az UMDF 1 x illesztőprogramokkal, valamint a UMDF 2.0 és újabb illesztőprogramokkal.
VerifyDownLevel (REG_DWORD)
Ha a VerifyDownLevel értéke nem nulla, és ha az illesztőprogram a keretrendszernek az aktuális verziónál régebbi verziójával készült, a keretrendszer ellenőrzője az illesztőprogram létrehozása után hozzáadott teszteket is tartalmaz. Ha ez az érték nem létezik, vagy nullára van állítva, a keretrendszer ellenőrzője csak azokat a teszteket tartalmazza, amelyek az illesztőprogram létrehozásakor léteztek.
Ha például az illesztőprogram a keretrendszer 1.7-es verziójával készült, és ha a keretrendszer 1.9-es verziója telepítve van a számítógépen, akkor a VerifyDownLevel nemzero értékre állítása esetén a hitelesítő az illesztőprogram futtatásakor hozzáadta a hitelesítő 1.9-es verziójához hozzáadott teszteket.
Ez az érték a HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\WUDF\Services\DriverName beállításkulcs Parameters\Wdf alkulcsában található.
TrackObjects (REG_DWORD)
Ha a TrackObjects nemzero értékre van állítva, a keretrendszer az illesztőprogram eltávolításakor belép a hibakeresőbe, ha a keretrendszeren alapuló objektumok kiszivárogtak (nem törölték).
A rendszeres tesztelés során engedélyeznie kell a TrackObjectset , és nem a TrackRefCounts-t. Ha a hitelesítő azt jelenti, hogy az illesztőprogram keretrendszerobjektumokat szivárgott ki, akkor a vezérlőalkalmazással engedélyezze a TrackRefCounts hitelesítő beállítást.
Ez az érték a HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\WUDF\Services beállításkulcs DefaultHostProcessGuid alkulcsában található, ahol a DefaultHostProcessGuid az HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\WUDF alkulcsban található érték.
TrackRefCounts (REG_DWORD)
Ha a TrackRefCounts értéke nem nulla, a keretrendszer fenntartja az egyes keretrendszeralapú objektumokra mutató hivatkozások számát. A !wudfrefhist hibakereső bővítmény használatával megtekintheti egy objektum hivatkozásszámának változásait.
Ha a TrackRefCounts értékét nemero értékre állítja, az rontja az illesztőprogram teljesítményét, ezért az értéket nullára kell hagynia, kivéve, ha objektumtörlési hibát keres.
Ez az érték a HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\WUDF\Services beállításkulcs DefaultHostProcessGuid alkulcsában található, ahol a DefaultHostProcessGuid az HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\WUDF alkulcsban található érték.
A fent felsorolt beállításjegyzék-értékek mellett az UMDF 2.0 és újabb illesztőprogramok a KMDF Verifierben felsorolt beállításjegyzék-értékek nagy részét is használhatják.