Pseudo-Register Syntax

Der Debugger unterstützt mehrere Pseudoregister, die bestimmte Werte enthalten.

Der Debugger legt automatische Pseudoregister auf bestimmte nützliche Werte fest. Benutzerdefinierte Pseudoregister sind ganzzahlige Variablen, in die Sie schreiben oder lesen können.

Alle Pseudoregister beginnen mit einem Dollarzeichen ($). Wenn Sie die MASM-Syntax verwenden, können Sie vor dem Dollarzeichen ein at-Zeichen ( @ ) hinzufügen. Dieses At-Zeichen teilt dem Debugger mit, dass das folgende Token ein Register oder Pseudoregister und kein Symbol ist. Wenn Sie das at-Zeichen weglassen, reagiert der Debugger langsamer, da er die gesamte Symboltabelle durchsuchen muss.

Beispielsweise erzeugen die folgenden beiden Befehle dieselbe Ausgabe, aber der zweite Befehl ist schneller.

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

Wenn ein Symbol mit demselben Namen wie das Pseudoregister vorhanden ist, müssen Sie das At-Zeichen hinzufügen.

Wenn Sie die Syntax des C++-Ausdrucks verwenden, ist immer das At-Zeichen ( @ ) erforderlich.

Der Befehl r (Registers) ist eine Ausnahme von dieser Regel. Der Debugger interpretiert sein erstes Argument immer als Register oder Pseudoregister. (Ein At-Zeichen ist nicht erforderlich oder zulässig.) Wenn ein zweites Argument für den r-Befehl vorhanden ist, wird es gemäß der Standardausdruckssyntax interpretiert. Wenn die Standardausdruckssyntax C++ lautet, müssen Sie den folgenden Befehl verwenden, um das Pseudoregister $t 2 in das Pseudoregister $t 1 zu kopieren.

0:000> r $t1 = @$t2

Automatische Pseudo-Registers

Der Debugger legt automatisch die folgenden Pseudoregister fest.

Einige dieser Pseudoregister sind in bestimmten Debugszenarien möglicherweise nicht verfügbar. Sie können beispielsweise $peb, $tid und $tpid nicht verwenden, wenn Sie eine Minidump-Datei im Benutzermodus oder bestimmte Kernelmodus-Dumpdateien debuggen. Es gibt Situationen, in denen Sie Threadinformationen von ~ (Threadstatus) lernen können, aber nicht von $tid. Sie können das $previp Pseudoregister nicht für das erste Debuggerereignis verwenden. Sie können das $relip Pseudoregister nur verwenden, wenn Sie die Branchablaufverfolgung verwenden. Wenn Sie ein nicht verfügbares Pseudoregister verwenden, tritt ein Syntaxfehler auf.

Ein Pseudoregister, das die Adresse einer Struktur wie $thread, $proc, $teb, $peb und $lastclrex enthält, wird nach dem richtigen Datentyp in der C++-Ausdrucksauswertung ausgewertet, jedoch nicht in der MASM-Ausdrucksauswertung. Beispielsweise zeigt der Befehl ? $teb die Adresse des TEB an, während der Befehl ?? @$teb die gesamte TEB-Struktur anzeigt. Weitere Informationen finden Sie unter Auswerten von Ausdrücken.

Auf einem Itanium-basierten Prozessor ist das iip-Register bündelbündig ausgerichtet, was bedeutet, dass es auf Slot 0 im Bundle zeigt, das die aktuelle Anweisung enthält, auch wenn ein anderer Slot ausgeführt wird. iip ist also nicht der vollständige Anweisungszeiger. Der $ip Pseudoregisters ist der eigentliche Anweisungszeiger, einschließlich des Bundles und des Slots. Die anderen Pseudoregister mit Adresszeigern ($ra, $retreg, $eventip, $previp, $relip und $exentry) haben dieselbe Struktur wie $ip auf allen Prozessoren.

Sie können den r-Befehl verwenden, um den Wert von $ip zu ändern. Diese Änderung ändert auch automatisch das entsprechende Register. Wenn die Ausführung fortgesetzt wird, wird sie an der neuen Anweisungszeigeradresse fortgesetzt. Dieses Register ist das einzige automatische Pseudoregister, das Sie manuell ändern können.

Hinweis In der MASM-Syntax können Sie das $ip Pseudoregister mit einem Punkt ( ) angeben. Sie fügen vor diesem Zeitraum kein at-Zeichen (@) hinzu und verwenden den Punkt nicht als ersten Parameter des r-Befehls . Diese Syntax ist in einem C++-Ausdruck nicht zulässig.

Automatische Pseudoregister ähneln automatischen Aliasen. Sie können jedoch automatische Aliase zusammen mit aliasbezogenen Token (z. B. ${ }) verwenden, und Sie können keine Pseudoregister mit solchen Token verwenden.

Benutzerdefinierte Pseudo-Registers

Es gibt 20 benutzerdefinierte Pseudoregister ($t 0, $t 1, ..., $t 19). Diese Pseudoregister sind Variablen, die Sie lesen und über den Debugger schreiben können. Sie können einen beliebigen ganzzahligen Wert in diesen Pseudoregistern speichern. Sie können als Schleifenvariablen besonders nützlich sein.

Um in eines dieser Pseudoregister zu schreiben, verwenden Sie den Befehl r (Registers), wie im folgenden Beispiel gezeigt.

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

Wie bei allen Pseudoregistern können Sie das benutzerdefinierte Pseudoregister in einem beliebigen Ausdruck verwenden, wie im folgenden Beispiel gezeigt.

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

Ein Pseudoregister wird immer als ganze Zahl eingegeben, es sei denn, Sie verwenden den Schalter ? zusammen mit dem Befehl r . Wenn Sie diesen Schalter verwenden, ruft das Pseudoregister den Typ dessen ab, was ihm zugewiesen ist. Der folgende Befehl weist z. B. den Typ UNICODE_STRING** und den wert der 0x0012FFBC $t 15 zu.

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

Benutzerdefinierte Pseudoregister verwenden null als Standardwert, wenn der Debugger gestartet wird.

Hinweis Die Aliase $u 0, $u 1, ..., $u 9 sind trotz ihrer ähnlichen Darstellung keine Pseudoregister. Weitere Informationen zu diesen Aliasen finden Sie unter Verwenden von Aliasen.

Beispiel

Im folgenden Beispiel wird ein Haltepunkt festgelegt, der jedes Mal erreicht wird, wenn der aktuelle Thread NtOpenFile aufruft. Dieser Haltepunkt wird jedoch nicht erreicht, wenn andere Threads NtOpenFile aufrufen.

kd> bp /t @$thread nt!ntopenfile

Beispiel

Im folgenden Beispiel wird ein Befehl ausgeführt, bis das Register einen angegebenen Wert enthält. Fügen Sie zunächst den folgenden Code für das bedingte Schrittschritt in eine Skriptdatei mit dem Namen "eaxstep" ein.

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

Geben Sie als Nächstes den folgenden Befehl aus.

t "$<eaxstep"

Der Debugger führt einen Schritt aus und führt dann ihren Befehl aus. In diesem Fall führt der Debugger das Skript aus, das entweder 1234 anzeigt oder den Prozess wiederholt.