VOID EngDebugPrint(
PCHAR StandardPrefix, | |
PCHAR DebugMessage, | |
va_list ap | |
); |
EngDebugPrint prints the specified debug message to the kernel debugger.
Parameters
StandardPrefix
Points to a string that is prepended to DebugMessage.
DebugMessage
Points to a string containing the debug message to be printed.
ap
Variable argument list.
Comments
EngDebugPrint is useful for debugging drivers that are under development. It prints StandardPrefix, followed by DebugMessage, to the kernel debugger.
The StandardPrefix parameter acts as a unique identifier of the driver executing the debug statement; therefore, the same string should be used for all calls to EngDebugPrint by a single driver.
The DebugMessage parameter is a variable argument ASCII C string; that is, it can contain both ordinary characters and C-style conversion specifications. The argument list contained in ap can have any number of variable arguments in it.
An example use of EngDebugPrint follows:
#define STANDARD_DEBUG_PREFIX "S3: "
LONG bank;
LONG width;
...
EngDebugPrint(STANDARD_DEBUG_PREFIX, "Bank: %lx; Width: %li", bank, width);
See Also