Función EngDebugPrint (winddi.h)
La función EngDebugPrint imprime el mensaje de depuración especificado en el depurador de kernel.
Sintaxis
ENGAPI VOID EngDebugPrint(
[in] PCHAR StandardPrefix,
[in] PCHAR DebugMessage,
[in] va_list ap
);
Parámetros
[in] StandardPrefix
Puntero a una cadena que se antepone a DebugMessage.
[in] DebugMessage
Puntero a una cadena que contiene el mensaje de depuración que se va a imprimir.
[in] ap
Especifica la lista de argumentos de variable.
Valor devuelto
None
Observaciones
EngDebugPrint es útil para depurar controladores que están en desarrollo. Imprime StandardPrefix, seguido de DebugMessage, en el depurador de kernel.
El parámetro StandardPrefix actúa como un identificador único del controlador que ejecuta la instrucción de depuración; por lo tanto, se debe usar la misma cadena para todas las llamadas a EngDebugPrint por un único controlador.
El parámetro DebugMessage es una cadena C de argumento variable ASCII; es decir, puede contener caracteres normales y especificaciones de conversión de estilo C. La lista de argumentos contenida en ap puede tener cualquier número de argumentos de cualquier tipo.
A continuación se muestra un ejemplo de uso de EngDebugPrint :
#define STANDARD_DEBUG_PREFIX "Permedia: "
LONG bank;
LONG width;
...
VOID MyDebugPrint(PCHAR DebugMessage, ...)
{
va_list ap;
va_start(ap, DebugMessage);
EngDebugPrint(STANDARD_DEBUG_PREFIX, DebugMessage, ap);
va_end(ap);
}
...
MyDebugPrint("Bank: %lx; Width: %ld", bank, width);
Requisitos
| Cliente mínimo compatible | Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows. |
| Plataforma de destino | Universal |
| Encabezado | winddi.h (incluya Winddi.h) |
| Library | Win32k.lib |
| Archivo DLL | Win32k.sys |