wt (datos de seguimiento y inspección)
El comando wt se ejecuta a través de toda la función y, a continuación, muestra estadísticas cuando se ejecuta este comando al principio de una llamada de función.
wt [WatchOptions] [= StartAddress] [EndAddress]
Parámetros
WatchOptions
Especifica cómo modificar la presentación. Puede usar cualquiera de las siguientes opciones.
| Opción | Efecto |
|---|---|
-lProfundidad |
(Solo modo de usuario) Especifica la profundidad máxima de las llamadas que se van a mostrar. Las llamadas que sean al menos niveles de profundidad más profundas que el punto inicial se ejecutan de forma silenciosa. |
-mMódulo |
(Solo modo de usuario) Restringe la presentación al código dentro del módulo especificado, además del primer nivel de llamadas realizadas desde ese módulo. Puede incluir varias opciones -m para mostrar código de varios módulos y ningún otro módulo. |
-iModule |
(Solo modo de usuario) Omite cualquier código dentro del módulo especificado. Puede incluir varias opciones de -i para omitir el código de varios módulos. Si usa una opción -m, el depurador omite todas las opciones de -i. |
-ni |
(Solo modo de usuario) No muestra ninguna entrada en el código que se omite debido a una opción -m o -i. |
-Nc |
No muestra información de llamada individual. |
-Ns |
No muestra información de resumen. |
-Nw |
No muestra advertencias durante el seguimiento. |
-oa |
(Solo modo de usuario) Muestra la dirección real de los sitios de llamada. |
-or |
(Solo modo de usuario) Muestra los valores de registro devueltos de la función a la que se ha llamado, utilizando el radix predeterminado como base. |
-O |
(Solo modo de usuario) Muestra los valores de registro devueltos de la función llamada, en el tipo adecuado para cada valor devuelto. |
StartAddress
Especifica la dirección donde comienza la ejecución el depurador. Si no usa StartAddress, la ejecución comienza en la instrucción a la que apunta el puntero de instrucción. Para obtener más información sobre la sintaxis, vea Sintaxis de intervalo de direcciones y direcciones.
EndAddress
Especifica la dirección donde finaliza el seguimiento. Si no usa EndAddress, se ejecuta una sola instrucción o llamada de función.
Entorno
Modos |
Modo de usuario, modo kernel |
Destinos |
Solo depuración activa |
Plataformas |
Modo de usuario: todo el modo kernel: solo basado en x86 |
Información adicional
Para obtener más información sobre cómo emitir el comando wt y una introducción a los comandos relacionados, vea Controlar el destino.
Comentarios
El comando wt es útil si desea obtener información sobre el comportamiento de una función específica, pero no desea recorrer la función. En su lugar, vaya al principio de esa función y, a continuación, emita el comando wt .
Si el contador del programa está en un punto que corresponde a un símbolo (como el principio de una función o un punto de entrada en un módulo), el comando wt realiza un seguimiento hasta que llega a la dirección de retorno actual. Si el contador del programa está en una instrucción de llamada , el comando wt realiza un seguimiento hasta que vuelve a la ubicación actual. Este seguimiento se genera en la ventana Comando del depurador junto con la salida que describe las distintas llamadas que encuentra el comando.
Si el comando wt se emite en algún lugar distinto del principio de una función, el comando se comporta como el comando p (paso). Sin embargo, si especifica EndAddress, la ejecución continúa hasta que se alcanza esa dirección, incluso si esta ejecución implica muchos pasos de programa y llamadas de función.
Al depurar en modo de origen, solo debe realizar un seguimiento en la función hasta el punto en el que vea el corchete de apertura del cuerpo de la función. A continuación, puede usar el comando wt . (Normalmente, es más fácil insertar un punto de interrupción en la primera línea de la función o usar Depurar | Ejecute hasta cursor y, a continuación, use el comando wt ).
Dado que la salida de wt puede ser larga, es posible que desee usar un archivo de registro para registrar la salida.
En el ejemplo siguiente se muestra un archivo de registro típico.
0:000> l+ Source options set to show source lines
Source options are f:
1/t - Step/trace by source line
2/l - List source line for LN and prompt
4/s - List source code at prompt
8/o - Only show source code at prompt
0:000> p Not yet at the function call: use "p"
> 44: minorVariableOne = 12;
0:000> p
> 45: variableOne = myFunction(2, minorVariable);
0:000> t At the function call: now use "t"
MyModule!ILT+10(_myFunction):
0040100f e9cce60000 jmp MyModule!myFunction (0040f6e0)
0:000> t
> 231: {
0:000> wt At the function beginning: now use "wt"
Tracing MyModule!myFunction to return address 00401137
105 0 [ 0] MyModule!myFunction
1 0 [ 1] MyModule!ILT+1555(_printf)
9 0 [ 1] MyModule!printf
1 0 [ 2] MyModule!ILT+370(__stbuf)
11 0 [ 2] MyModule!_stbuf
1 0 [ 3] MyModule!ILT+1440(__isatty)
14 0 [ 3] MyModule!_isatty
50 15 [ 2] MyModule!_stbuf
17 66 [ 1] MyModule!printf
1 0 [ 2] MyModule!ILT+980(__output)
59 0 [ 2] MyModule!_output
39 0 [ 3] MyModule!write_char
111 39 [ 2] MyModule!_output
39 0 [ 3] MyModule!write_char
....
11 0 [ 5] kernel32!__SEH_epilog4
54 11675 [ 4] kernel32!ReadFile
165 11729 [ 3] MyModule!_read
100 11895 [ 2] MyModule!_filbuf
91 11996 [ 1] MyModule!fgets
54545 83789 [ 0] MyModule!myFunction
1 0 [ 1] MyModule!ILT+1265(__RTC_CheckEsp)
2 0 [ 1] MyModule!_RTC_CheckEsp
54547 83782 [ 0] MyModule!myFunction
112379 instructions were executed in 112378 events (0 from other threads)
Function Name Invocations MinInst MaxInst AvgInst
MyModule!ILT+1265(__RTC_CheckEsp) 1 1 1 1
MyModule!ILT+1440(__isatty) 21 1 1 1
MyModule!ILT+1540(__ftbuf) 21 1 1 1
....
ntdll!memcpy 24 1 40 19
ntdll!memset 2 29 29 29
23 system calls were executed
Calls System Call
23 ntdll!KiFastSystemCall
En la lista del seguimiento, el primer número especifica el número de instrucciones que se ejecutaron, el segundo número especifica el número de instrucciones ejecutadas por procesos secundarios de la función y el tercer número (entre corchetes) especifica la profundidad de la función en la pila (tomando la función inicial como cero). La sangría del nombre de la función muestra la profundidad de la llamada.
En el ejemplo anterior, MyModule!myFunction ejecuta 105 instrucciones antes de llamar a varias subrutinas, como printf y fgets, y luego ejecuta 54545 instrucciones adicionales después de llamar a esas funciones, pero antes de emitir algunas llamadas más. Sin embargo, en el recuento final, la pantalla muestra que myFunction ejecuta 112 379 instrucciones, ya que este recuento incluye todas las instrucciones que se ejecutan myFunction y sus elementos secundarios. (Los elementos secundarios de myFunction son funciones a las que se llama desde myFunction, ya sea directa o indirectamente).
En el ejemplo anterior, tenga en cuenta también que ILT+1440 (__isatty) se llama 21 veces. En el recuento final, el resumen del comportamiento de esta función muestra el número de veces que se llamó, el menor número de instrucciones de cualquier ejecución única, el mayor número de instrucciones de cualquier ejecución única y el número medio de instrucciones por ejecución.
Si se realizan llamadas al sistema, aparecen en el contador y se muestran de nuevo al final de la salida del comando.
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de