Pseudo-Register Syntax

Felsökningsprogrammet stöder flera pseudoregister som innehåller vissa värden.

Felsökningsprogrammet anger automatiska pseudoregister till vissa användbara värden. Användardefinierade pseudoregister är heltalsvariabler som du kan skriva till eller läsa.

Alla pseudoregister börjar med ett dollartecken ($). Om du använder MASM-syntax kan du lägga till ett vidtecken ( @ ) före dollartecknet. Det här '@'-tecknet anger för felsökaren att följande token är ett register eller pseudoregister, inte en symbol. Om du utelämnar vid-tecknet svarar felsökningsprogrammet långsammare eftersom det måste söka i hela symboltabellen.

Följande två kommandon genererar till exempel samma utdata, men det andra kommandot är snabbare.

0:000> ? $exp
Evaluate expression: 143 = 0000008f
0:000> ? @$exp
Evaluate expression: 143 = 0000008f

Om en symbol finns med samma namn som pseudoregistret måste du lägga till vid-tecknet.

Om du använder syntaxen för C++-uttryck krävs alltid vid -tecknet ( @ ).

Kommandot r (Registers) är ett undantag från den här regeln. Felsökningsprogrammet tolkar alltid sitt första argument som ett register eller pseudoregister. (En snabel-a krävs inte eller tillåts inte.) Om det finns ett andra argument för r-kommandot tolkas det enligt standarduttryckssyntaxen. Om standarduttryckssyntaxen är C++, måste du använda följande kommando för att kopiera pseudoregistret $t 2 till pseudoregistret $t 1 .

0:000> r $t1 = @$t2

Automatisk Pseudo-Registers

Felsökningsprogrammet anger automatiskt följande pseudoregister.

Vissa av dessa pseudoregister kanske inte är tillgängliga i vissa felsökningsscenarier. Du kan till exempel inte använda $peb, $tid och $tpid när du felsöker en minidump i användarläge eller vissa dumpfiler i kernelläge. Det kommer att finnas situationer där du kan lära dig trådinformation från ~ (trådstatus) men inte från $tid. Du kan inte använda $previp pseudoregister för den första felsökningshändelsen. Du kan inte använda pseudoregistret $relip om du inte spårar förgreningar. Om du använder ett otillgängligt pseudoregister uppstår ett syntaxfel.

Ett pseudoregister som innehåller adressen för en struktur – till exempel $thread, $proc, $teb, $peb och $lastclrex – utvärderas enligt rätt datatyp i utvärderingsverktyget för C++-uttryck, men inte i MASM-uttrycksutvärderingen. Kommandot ? $teb visar teb-adressen, medan kommandot ?? @$teb visar hela TEB-strukturen. Mer information finns i Utvärdera uttryck.

På en Itanium-baserad processor är iip-registret bundlejusterat, vilket innebär att det pekar på plats 0 i paketet som innehåller den aktuella instruktionen, även om en annan plats utförs. Så iip är inte den fullständiga instruktionspekaren. $ip-pseudoregistret är den faktiska instruktionspekaren, inklusive bunten och platsen. De andra pseudoregister som innehåller adresspekare ($ra, $retreg, $eventip, $previp, $relip och $exentry) har samma struktur som $ip på alla processorer.

Du kan använda r-kommandot för att ändra värdet för $ip. Den här ändringen ändrar också automatiskt motsvarande register. När körningen återupptas sker det vid den nya instruktionspekarens adress. Det här registret är det enda automatiska pseudoregistret som du kan ändra manuellt.

Obs I MASM-syntax kan du indikera $ip pseudoregister med en punkt ( . ). Du lägger inte till ett vidtecken (@) före den här perioden och använder inte perioden som den första parametern för r-kommandot . Den här syntaxen tillåts inte i ett C++-uttryck.

Automatiska pseudoregister liknar automatiska alias. Men du kan använda automatiska alias tillsammans med aliasrelaterade token (till exempel ${ }), och du kan inte använda pseudoregister med sådana token.

User-Defined Pseudo-Registers

Det finns 20 användardefinierade pseudoregister ($t 0, $t 1, ..., $t 19). Dessa pseudoregister är variabler som du kan läsa och skriva via felsökningsprogrammet. Du kan lagra alla heltalsvärden i dessa pseudoregister. De kan vara särskilt användbara som loopvariabler.

Om du vill skriva till ett av dessa pseudoregister använder du kommandot r (Registers), som i följande exempel visas.

0:000> r $t0 = 7
0:000> r $t1 = 128*poi(MyVar)

Precis som alla pseudoregister kan du använda det användardefinierade pseudoregistret i valfritt uttryck, vilket visas i följande exempel.

0:000> bp $t3 
0:000> bp @$t4 
0:000> ?? @$t1 + 4*@$t2 

Ett pseudoregister skrivs alltid som ett heltal, såvida du inte använder växeln ? tillsammans med r-kommandot . Om du använder den här växeln antar pseudoregistret typen av vad som tilldelas den. Följande kommando tilldelar till exempel typen UNICODE_STRING** och värdet 0x0012FFBC till $t 15.

0:000> r? $t15 = * (UNICODE_STRING*) 0x12ffbc

Användardefinierade pseudoregister använder noll som standardvärde när felsökningsprogrammet startas.

Obs Aliaserna $u0, $u1, ..., $u9 är inte pseudoregister, trots deras liknande utseende. Mer information om dessa alias finns i Använda alias.

exempel

I följande exempel anges en brytpunkt som slås varje gång den aktuella tråden anropar NtOpenFile. Men den här brytpunkten uppnås inte när andra trådar anropar NtOpenFile.

kd> bp /t @$thread nt!ntopenfile

exempel

I följande exempel körs ett kommando tills registret innehåller ett angivet värde. Placera först följande kod för villkorsstyrd stegning i en skriptfil med namnet "eaxstep".

.if (@eax == 1234) { .echo 1234 } .else { t "$<eaxstep" }

Utfärda sedan följande kommando.

t "$<eaxstep"

Felsökningsprogrammet utför ett steg och kör sedan kommandot. I det här fallet kör felsökningsprogrammet skriptet, som antingen visar 1234 eller upprepar processen.