DbgPrint 函式 (wdm.h)
當您指定套用的條件時,
語法
ULONG DbgPrint(
PCSTR Format,
...
);
參數
Format
指定要列印之格式字串的指標。 Format 字串支援大部分 printf樣式 格式規格字段。 不過,Unicode 格式代碼(%C、%S、%lc、%ls、%wc、%ws和 %wZ)只能與 IRQL = PASSIVE_LEVEL搭配使用。 DbgPrint 例程不支援任何浮點類型(%f、%e、%E、%g、%G、%a或 %A)。
...
指定格式字串的自變數,如 printf 中所示。
傳回值
如果成功,DbgPrint 會傳回NTSTATUS程式碼STATUS_SUCCESS;否則會傳回適當的錯誤碼。
言論
DbgPrint 和 DbgPrintEx 可以在 IRQL<=DIRQL 呼叫。 不過,Unicode 格式代碼(%C、%S、%lc、%ls、%wc、%ws和 %wZ)只能用於 IRQL=PASSIVE_LEVEL。 此外,由於調試程式會使用進程間中斷 (IPIs) 與其他處理器通訊,因此在 IRQL>DIRQL 呼叫 dbgPrint,可能會導致死結。
只有內核模式驅動程式可以呼叫 DbgPrint 例程。
DbgPrint 只有在套用特定條件時才會傳送訊息。 具體來說,其行為類似於具有 DEFAULT 元件的 DbgPrintEx 例程,以及DPFLTR_INFO_LEVEL的訊息重要性層級。 換句話說,下列兩個函式呼叫完全相同:
DbgPrint ( Format, arguments )
DbgPrintEx ( DPFLTR_DEFAULT_ID, DPFLTR_INFO_LEVEL, Format, arguments )
如需訊息篩選、元件和訊息重要性層級的詳細資訊,請參閱 讀取和篩選偵錯訊息。
建議您使用 DbgPrintEx,而不是 DbgPrint,因為這可讓您控制訊息傳送的條件。
除非絕對必要,否則您不應該從使用者輸入或其他進程取得字串,並將它傳遞給 DbgPrint。 如果您使用未建立的字串,您必須確認這是有效的格式字串,而且格式代碼符合類型和數量中的自變數清單。 最佳編碼作法是讓所有 Format 字串在編譯時期為靜態和定義。
Format 字串的大小或自變數數目沒有上限。 不過,對 dbgPrint 的任何單一呼叫只會傳輸 512 個字節的資訊。 DbgPrint 緩衝區的大小也有限制。 如需詳細資訊,請參閱 DbgPrint 緩衝區和調試程式。
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
標頭 | wdm.h (包括 Wdm.h) |
連結庫 | NtDll.lib (使用者模式):NtosKrnl.lib (核心模式) |
DLL | NtDll.dll (使用者模式):NtosKrnl.exe (核心模式) |
IRQL | IRQL <= DIRQL (請參閱批注一節) |