PWINDBG_OUTPUT_ROUTINE función de devolución de llamada (wdbgexts.h)

  • Artículo

La función de devolución de llamada implementa la funcionalidad para imprimir una cadena con formato en la ventana Comando del depurador.

El encabezado wdbgexts.h declara una macro, dprintf que imprime la cadena con formato. Funciona como el printf de rutina del lenguaje C.

Sintaxis

PWINDBG_OUTPUT_ROUTINE PwindbgOutputRoutine;

void PwindbgOutputRoutine(
  [in] PCSTR lpFormat,
  [in] ... unnamedParam2
)
{...}

Parámetros

[in] lpFormat

Especifica la cadena de formato, como en printf. En general, los caracteres de conversión funcionan exactamente como en C. Para los caracteres de conversión de punto flotante, el argumento de 64 bits se interpreta como un número de punto flotante de 32 bits a menos que se use el modificador l .

Se admite el carácter de conversión %p , pero representa un puntero en el espacio de direcciones virtuales del destino. Es posible que no tenga ningún modificador y use el formato de dirección interna del depurador. Se admiten los siguientes caracteres de conversión adicionales:

Carácter Tipo de argumento Argumento Texto impreso
%p ULONG64 Puntero en el espacio de direcciones virtuales del destino Valor del puntero.
%N DWORD_PTR (32 o 64 bits, según la arquitectura del host ) Puntero en el espacio de direcciones virtuales del host Valor del puntero. (Esto equivale al carácter estándar de C %p ).
%I ULONG64 Cualquier valor de 64 bits Valor especificado. Si es mayor que 0xFFFFFFFF se imprime como una dirección de 64 bits, de lo contrario, se imprime como una dirección de 32 bits.
%ma ULONG64 Dirección de una cadena ASCII terminada en NULL en el espacio de direcciones virtuales del destino Cadena especificada.
%mu ULONG64 Dirección de una cadena Unicode terminada en NULL en el espacio de direcciones virtuales del destino Cadena especificada.
%msa ULONG64 Dirección de una estructura de ANSI_STRING en el espacio de direcciones virtuales del destino Cadena especificada.
%msu ULONG64 Dirección de una estructura de UNICODE_STRING en el espacio de direcciones virtuales del destino Cadena especificada.
%y ULONG64 Dirección de un símbolo del depurador en el espacio de direcciones virtuales del destino Cadena que contiene el nombre del símbolo especificado (y desplazamiento, si existe).
%ly ULONG64 Dirección de un símbolo del depurador en el espacio de direcciones virtuales del destino Cadena que contiene el nombre del símbolo especificado (y desplazamiento, si existe), así como cualquier información de línea de origen disponible.

[in] unnamedParam2

[argumentos] : especifica argumentos para la cadena de formato, como en printf. El número de argumentos especificados debe coincidir con el número de caracteres de conversión en FormatString. Cada argumento es una expresión que se evaluará mediante el evaluador de expresiones predeterminado (MASM o C++). Para más información, consulte Sintaxis de expresión numérica.

Valor devuelto

None

Observaciones

Al generar cadenas de salida muy grandes, es posible que se alcancen los límites del motor del depurador o del sistema operativo. Por ejemplo, algunas versiones del motor del depurador tienen un límite de 16 000 caracteres para una sola parte de la salida. Si observa que la salida muy grande se está truncando, es posible que tenga que dividir la salida en varias solicitudes.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado wdbgexts.h (include Wdbgexts.h, Dbgeng.h)