Leer en inglés

Compartir a través de


Método IDebugControl4::OutputVaListWide (dbgeng.h)

El método OutputVaListWide da formato a una cadena y envía el resultado a las devoluciones de llamada de salida registradas con los clientes del motor.

Sintaxis

HRESULT OutputVaListWide(
  [in] ULONG   Mask,
  [in] PCWSTR  Format,
  [in] va_list Args
);

Parámetros

[in] Mask

Especifica el campo de bits de tipo de salida. Consulte DEBUG_OUTPUT_XXX para obtener los valores posibles.

[in] Format

Especifica la cadena de formato, como en printf. Normalmente, los caracteres de conversión funcionan exactamente igual que 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 de un destino. Es posible que no tenga modificadores 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 un espacio de direcciones. 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 un valor de 64 bits; de lo contrario, se imprime como un valor de 32 bits.
%ma ULONG64 Dirección de una cadena ASCII terminada en NULL en el espacio de direcciones virtuales del proceso. Cadena especificada.
%mu ULONG64 Dirección de una cadena Unicode terminada en NULL en el espacio de direcciones virtuales del proceso. Cadena especificada.
%msa ULONG64 Dirección de una estructura de ANSI_STRING en el espacio de direcciones virtuales del proceso. Cadena especificada.
%msu ULONG64 Dirección de una estructura de UNICODE_STRING en el espacio de direcciones virtuales del proceso. Cadena especificada.
%y ULONG64 Dirección en el espacio de direcciones virtuales del proceso de un elemento con información de símbolos. Cadena que contiene el nombre del símbolo especificado (y desplazamiento, si existe).
%ly ULONG64 Dirección en el espacio de direcciones virtuales del proceso de un elemento con información de símbolos. 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] Args

Especifica parámetros adicionales que representan los valores que se van a insertar en la salida durante el formato. Los argumentos deben inicializarse mediante va_start. Este método no llama a va_end.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto Descripción
S_OK
Método realizado correctamente.

Comentarios

Al generar cadenas de salida muy grandes, es posible alcanzar 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 única salida. Si observa que la salida muy grande se trunca, es posible que tenga que dividir la salida en varias solicitudes.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado dbgeng.h (include Dbgeng.h, Stdarg.h)

Consulte también

ControlledOutputVaList

IDebugControl4

Salida

dprintf