EngDebugPrint 函数 (winddi.h)

EngDebugPrint 函数将指定的调试消息输出到内核调试器。

语法

ENGAPI VOID EngDebugPrint(
  [in] PCHAR   StandardPrefix,
  [in] PCHAR   DebugMessage,
  [in] va_list ap
);

参数

[in] StandardPrefix

指向在 DebugMessage 前面追加的字符串的指针。

[in] DebugMessage

指向包含要打印的调试消息的字符串的指针。

[in] ap

指定变量参数列表。

返回值

无

备注

EngDebugPrint 可用于调试正在开发的驱动程序。 它将 StandardPrefix 和 DebugMessage 打印到内核调试器。

StandardPrefix 参数充当执行调试语句的驱动程序的唯一标识符;因此，对于单个驱动程序对 EngDebugPrint 的所有调用，应使用相同的字符串。

DebugMessage 参数是变量参数 ASCII C 字符串;也就是说，它可以包含普通字符和 C 样式转换规范。 ap 中包含的参数列表可以包含任意数量的任何类型的参数。

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);

注意 Microsoft Windows 驱动程序工具包 (WDK) 不包含 Permedia (3dlabs.htm 和 Perm3.htm) 和 FrameBuffer (Framebuf.htm) 示例显示驱动程序。 可以从 Windows Server 2003 SP1 驱动程序开发工具包 (DDK) 获取这些示例驱动程序，可以从 WDHC 网站的 DDK - Windows 驱动程序开发工具包 页面下载。

 

要求

最低受支持的客户端	在 Windows 2000 及更高版本的 Windows 操作系统中可用。
目标平台	通用
标头	winddi.h (包括 Winddi.h)
Library	Win32k.lib
DLL	Win32k.sys

另请参阅

EngDebugBreak