Hibakereső motor – bevezetés

Ez a dokumentáció bemutatja, hogyan használhatja a hibakereső motort, és hogyan írhat olyan bővítményeket, amelyek WinDbg, KD, CDB és NTSD nyelven fognak futni. Ezek a hibakeresőbővítmények felhasználói vagy kernel módú hibakereséshez használhatók a Microsoft Windowson.

Hibakereső motor

A hibakereső motor felületet biztosít a hibakeresési célok vizsgálatához és kezeléséhez felhasználói módban és kernel módban a Microsoft Windowson.

A hibakereső motor célokat szerezhet be, töréspontokat állíthat be, eseményeket figyelhet, lekérdezési szimbólumokat, olvasási és írási memóriát írhat, valamint vezérelheti a célszálakat és folyamatokat.

A hibakereső motorral hibakereső bővítménytárakat és önálló alkalmazásokat is írhat. Ezek az alkalmazások hibakereső motoralkalmazások. A hibakereső motor teljes funkcionalitását használó hibakereső motoralkalmazás egy hibakereső. A WinDbg, a CDB, az NTSD és a KD például hibakeresők; a hibakereső motor biztosítja a működésük lényegét.

A hibakereső motor API-ját a dbgeng.h fejlécfájlban található prototípusok határozzák meg.

Hiányos dokumentáció

Ez egy előzetes dokumentum, és jelenleg hiányos.

Az itt még nem dokumentált hibakeresőkkel és hibakereső motorral kapcsolatos számos fogalomért tekintse meg a dokumentáció hibakeresési technikák szakaszát.

A hibakereső motor API néhány jelenleg még nem dokumentált funkciójának beszerzéséhez használja a Execute metódust az egyes hibakereső parancsok végrehajtásához.

bővítmények

Létrehozhat saját hibakeresési parancsokat egy bővítmény DLL írásával és létrehozásával. Előfordulhat például, hogy egy bővítményparancsot szeretne írni egy összetett adatstruktúra megjelenítéséhez.

A hibakereső bővítmény DLL-jének három különböző típusa létezik:

• DbgEng bővítmény DLL-ek. Ezek a dbgeng.h fejlécfájlban szereplő prototípusokon alapulnak. Az ilyen típusú DLL-ek exportálhatják a DbgEng bővítményparancsokat. Ezek a bővítményparancsok a Debugger Engine API-t használják, és használhatják a WdbgExts API-t is.

• EngExtCpp bővítmény DLL-ek. Ezek az engextcpp.h és a dbgeng.h fejlécfájlok prototípusán alapulnak. Az ilyen típusú DLL-ek exportálhatják a DbgEng bővítményparancsokat. Ezek a bővítményparancsok a Debugger Engine API-t és az EngExtCpp bővítmény-keretrendszert is használják, és használhatják a WdbgExts API-t is.

• WdbgExts bővítmény DLL-ek. Ezek a wdbgexts.h fejlécfájlban található prototípusokon alapulnak. Minden ilyen típusú DLL exportál egy vagy több WdbgExts-bővítményparancsot. Ezek a bővítményparancsok kizárólag a WdbgExts API-t használják.

A DbgEng API bővítmények vagy önálló alkalmazások létrehozásához használható. A WdbgExts API a hibakereső motor API funkcióinak egy részét tartalmazza, és csak bővítmények használhatják.

Az összes hibakereső bővítményt a Build segédprogrammal kell lefordítani és létrehozni. A Build segédprogram a Windows Driver Kit (WDK) része.

A bővítménykódminták a Windows hibakeresési eszközei csomag részeként vannak telepítve, ha egyéni telepítést végez, és kiválasztja a SDK összetevőt és annak összes alkomponensét. Ezek a Windows-telepítési címtár hibakeresési eszközeinek sdk\samples alkönyvtárában találhatók.

Az új hibakereső bővítmények írásának legegyszerűbb módja a mintabővítmények tanulmányozása. Minden mintakiterjesztés tartalmazza a Build segédprogrammal használható makefile- és forrásfájlokat. A minták mindkét bővítménytípust képviselik.

egyéni elemzési hibakereső bővítmények írása

Az elemzési bővítmény beépülő modul megírásával bővítheti a !analyze hibakereső parancs képességeit. Az elemzési bővítmény beépülő modul megadásával részt vehet egy hibaellenőrzés vagy kivétel elemzésében a saját összetevőjére vagy alkalmazására jellemző módon. Elemzési bővítmény beépülő modul írásakor egy metaadatfájlt is ír, amely leírja azokat a helyzeteket, amelyekre a beépülő modult meghívni szeretné. Amikor !analyze fut, megkeresi, betölti és futtatja a megfelelő bővítményeket. További információért lásd: Egyedi Elemzési Hibakereső Kiterjesztések

Hibakereső kimenetének testreszabása DML használatával

A hibakereső kimenetét a DML használatával szabhatja testre. További információ: Hibakereső kimenetének testreszabása DML-használatával.

JavaScript használata a hibakereső képességeinek kibővítéséhez

JavaScript használatával olyan szkripteket hozhat létre, amelyek megértik a hibakereső objektumokat, és kibővítik és testre szabják a hibakereső képességeit. A JavaScript-szolgáltatók összekapcsolják a szkriptelési nyelvet a debugger belső objektummodelljével. A JavaScript hibakereső szkriptszolgáltató lehetővé teszi a JavaScript használatát a hibakeresővel. További információ: JavaScript Debugger Scripting.