Sintaxis de Pseudo-Register

El depurador admite varios pseudo-registros que contienen determinados valores.

El depurador establece los pseudo-registros automáticos en determinados valores útiles. Los pseudo-registros definidos por el usuario son variables enteras que se pueden escribir en o leer.

Todos los pseudo-registros comienzan con un signo de dólar ($). Si usa la sintaxis de MASM, puede agregar un signo en signo ( @ ) antes del signo de dólar. Esto en signo indica al depurador que el siguiente token es un registro o pseudo-registro, no un símbolo. Si omite el signo, el depurador responde más lentamente, ya que tiene que buscar en toda la tabla de símbolos.

Por ejemplo, los dos comandos siguientes generan la misma salida, pero el segundo comando es más rápido.

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

Si existe un símbolo con el mismo nombre que el pseudo-registro, debe agregar el signo at.

Si usa la sintaxis de expresión de C++, siempre se requiere el signo at ( @ ).

El comando r (Registers) es una excepción a esta regla. El depurador siempre interpreta su primer argumento como registro o pseudo-registro. (No se requiere ni permite un signo). Si hay un segundo argumento para el comando r , se interpreta según la sintaxis de expresión predeterminada. Si la sintaxis de expresión predeterminada es C++, debe usar el siguiente comando para copiar el pseudo-registro de $t 2 en el pseudo-register de $t 1 .

0:000> r $t1 = @$t2

Pseudo-Registers automática

El depurador establece automáticamente los pseudo-registros siguientes.

Es posible que algunos de estos pseudo-registros no estén disponibles en determinados escenarios de depuración. Por ejemplo, no puede usar $peb, $tid y $tpid al depurar un minivolcado en modo de usuario o determinados archivos de volcado de modo kernel. Habrá situaciones en las que puede aprender información de subprocesos de ~ (estado del subproceso), pero no de $tid. No se puede usar el $previp pseudo-register en el primer evento del depurador. No puede usar el $relip pseudo-register a menos que sea el seguimiento de ramas. Si usa un pseudo-registro no disponible, se produce un error de sintaxis.

Un pseudo-registro que contiene la dirección de una estructura (como $thread, $proc, $teb, $peb y $lastclrex ) se evaluará según el tipo de datos adecuado en el evaluador de expresiones de C++, pero no en el evaluador de expresiones masm. Por ejemplo, el comando ? $teb muestra la dirección del TEB, mientras que el comando ?? @$teb muestra toda la estructura TEB. Para obtener más información, vea Evaluación de expresiones.

En un procesador basado en Itanium, el registro iip está alineado con agrupación, lo que significa que apunta a la ranura 0 del lote que contiene la instrucción actual, incluso si se ejecuta una ranura diferente. Por lo tanto , iip no es el puntero de instrucción completa. El $ip pseudo-register es el puntero de instrucción real, incluido el lote y la ranura. Los demás pseudo-registros que contienen punteros de dirección ($ra, $retreg, $eventip, $previp, $relip y $exentry) tienen la misma estructura que $ip en todos los procesadores.

Puede usar el comando r para cambiar el valor de $ip. Este cambio también cambia automáticamente el registro correspondiente. Cuando se reanuda la ejecución, se reanuda en la nueva dirección del puntero de instrucción. Este registro es el único pseudo-registro automático que puede cambiar manualmente.

Nota En la sintaxis de MASM, puede indicar el $ip pseudo-register con un punto ( . ). No agregue un signo a signo (@) antes de este período y no use el punto como primer parámetro del comando r . Esta sintaxis no se permite dentro de una expresión de C++.

Los pseudo-registros automáticos son similares a los alias automáticos. Sin embargo, puede usar alias automáticos junto con tokens relacionados con alias (como ${ }) y no puede usar pseudo-registros con dichos tokens.

Pseudo-Registers definidas por el usuario

Hay 20 pseudo-registros definidos por el usuario ($t 0, $t 1, ..., $t 19). Estos pseudo-registro son variables que se pueden leer y escribir a través del depurador. Puede almacenar cualquier valor entero en estos pseudo-registros. Pueden ser especialmente útiles como variables de bucle.

Para escribir en uno de estos pseudo-registros, use el comando r (Registers), como se muestra en el ejemplo siguiente.

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

Al igual que todos los pseudo-registros, puede usar el pseudo-registro definido por el usuario en cualquier expresión, como se muestra en el ejemplo siguiente.

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

Un pseudo-registro siempre se escribe como un entero, a menos que use el modificador ? junto con el comando r . Si usa este modificador, el pseudo-registro adquiere el tipo de lo que se le asigna. Por ejemplo, el siguiente comando asigna el tipo UNICODE_STRING** y el valor de 0x0012FFBC a $t 15.

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

Los pseudo-registros definidos por el usuario usan cero como valor predeterminado cuando se inicia el depurador.

Nota Los alias $u 0, $u 1, ..., $u 9 no son pseudo-registros, a pesar de su apariencia similar. Para obtener más información sobre estos alias, consulte Uso de alias.

Ejemplo

En el ejemplo siguiente se establece un punto de interrupción que se alcanza cada vez que el subproceso actual llama a NtOpenFile. Pero este punto de interrupción no se alcanza cuando otros subprocesos llaman a NtOpenFile.

kd> bp /t @$thread nt!ntopenfile

Ejemplo

En el ejemplo siguiente se ejecuta un comando hasta que el registro contiene un valor especificado. En primer lugar, coloque el código siguiente para la ejecución paso a paso condicional en un archivo de script denominado "eaxstep".

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

A continuación, emita el siguiente comando.

t "$<eaxstep"

El depurador realiza un paso y, a continuación, ejecuta el comando . En este caso, el depurador ejecuta el script, que muestra 1234 o repite el proceso.