Método IDebugControl3::OutputPromptVaList (dbgeng.h)
El método outputPromptVaList de y envía un mensaje de usuario a los objetos de devolución de llamada de salida .
Sintaxis
HRESULT OutputPromptVaList(
[in] ULONG OutputControl,
[in, optional] PCSTR Format,
[in] va_list Args
);
Parámetros
[in] OutputControl
Especifica un control de salida que determina cuál de las devoluciones de llamada de salida del cliente recibirá la salida. Para conocer los valores posibles, consulte DEBUG_OUTCTL_XXX.
[in, optional] 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. |
Si formato es null, solo se envía el texto del mensaje estándar a las devoluciones de llamada de salida.
[in] Args
Especifica parámetros adicionales que representan los valores que se van a insertar en la salida durante el formato. de Args se debe inicializar 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 información.
| Código devuelto | Descripción |
|---|---|
|
El método se realizó correctamente. |
Observaciones
OutputPromptVaList y OutputPromptVaListWide se pueden usar para solicitar al usuario la entrada.
El mensaje estándar se enviará a las devoluciones de llamada de salida antes del texto con formato descrito por Format. El método devuelve el contenido del símbolo del sistema estándar GetPromptText.
El texto del mensaje se envía a las devoluciones de llamada de salida con el DEBUG_OUTPUT_PROMPT conjunto de máscaras de salida.
Para obtener más información sobre cómo solicitar al usuario, vea Using Input and Output.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | dbgeng.h (include Dbgeng.h, Stdarg.h) |