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 作業系統。 |
目標平台 | Universal |
標頭 | winddi.h (包含 Winddi.h) |
程式庫 | Win32k.lib |
Dll | Win32k.sys |