Modules

En image är en körbar fil, DLL eller drivrutin som Windows har läst in som en del av en process i användarläge eller kärnan. Filen som avbildningen lästes in från kallas dess avbildningsfil.

Felsökningsmotorn cachelagrar en lista över moduler för varje process (eller, i kernelläge, den virtuella processen). Vanligtvis representerar varje modul i den här listan en bild i processen. Motorns modullista kan synkroniseras med målet med hjälp av Ladda om.

Not I kernellägesfelsökning innehåller motorns modullista för den virtuella processen både modulerna för systemomfattande kernelläge och den aktuella processens användarlägesmoduler.

En modul kan anges av dess basadress i målets virtuella adressutrymme, eller av dess index i listan över moduler som motorn underhåller för målet. Modulens index är lika med dess position i listan över moduler, och därför ändras det här indexet om en modul med ett lägre index tas bort. Alla oladdade moduler har index. dessa är alltid högre än indexen för inlästa moduler. Basadressen för en modul ändras inte så länge den förblir inläst. i vissa fall kan den ändras om modulen tas bort och sedan läses in igen.

Indexet är ett tal mellan noll och antalet moduler i målet minus ett. Antalet moduler i den aktuella processen kan hittas genom att anropa GetNumberModules.

Indexet kan användas för att hitta basadressen genom att anropa GetModuleByIndex. Basadressen för en modul som äger en symbol med ett förnamn finns med hjälp av GetSymbolModule.

Följande metoder returnerar både index- och basadressen för den angivna modulen:

• Om du vill hitta en modul med ett visst modulnamn använder du GetModuleByModuleName.

• Modulen vars virtuella adressintervall innehåller en viss adress returneras av GetModuleByOffset. Den här metoden kan användas för att hitta modulindexet med tanke på modulens basadress.

Följande metoder returnerar information om moduler som anges antingen efter basadress eller index:

• Namnen på en modul returneras av GetModuleNames och GetModuleNameString.

• Versionsinformation för modulen returneras av GetModuleVersionInformation.

• Några av de parametrar som används för att beskriva en modul returneras av GetModuleParameters. Mer information om de parametrar som returneras av den här metoden finns i DEBUG_MODULE_PARAMETERS.

Borttagna moduler

Under felsökning i användarläge spåras borttagna moduler endast i Windows Server 2003 och senare versioner av Windows. Tidigare versioner av Windows spårade endast oladdade moduler i kärnläge. När de spåras indexeras de efter de inlästa modulerna. Därför söker alla metoder som söker i målets moduler igenom alla inlästa moduler och sedan de borttagna modulerna. Borttagna moduler kan användas för att analysera fel som orsakas av ett försök att anropa oladdad kod.

Syntetiska moduler

Syntetiska moduler kan skapas som ett sätt att märka en minnesregion. Dessa moduler får inte innehålla verkliga symboler, men de kan innehålla syntetiska symboler. Metoden AddSyntheticModule skapar en ny syntetisk modul. Syntetiska moduler kan tas bort med RemoveSyntheticModule. Genom att läsa in alla moduler i målmiljön tas alla syntetiska moduler bort.

Bildsökväg

Den körbara avbildningssökvägen används av motorn vid sökning efter körbara avbildningar.

Den körbara bildsökvägen kan bestå av flera kataloger avgränsade med semikolon (;). Dessa kataloger genomsöks i ordning.

En översikt över den körbara bildsökvägen finns i Körbar bildsökväg.

Om du vill lägga till en katalog i den körbara avbildningssökvägen använder du metoden AppendImagePath. Hela sökvägen till den körbara avbilden returneras av GetImagePath och kan ändras med SetImagePath.

ytterligare information

Mer information om processer och virtuella processer finns i Trådar och processer.