vDbgPrintEx 函式 (wdm.h)

如果符合特定條件， vDbgPrintEx 例程會將字串傳送至核心調試程式。

語法

NTSYSAPI ULONG vDbgPrintEx(
  [in] ULONG   ComponentId,
  [in] ULONG   Level,
  [in] PCCH    Format,
  [in] va_list arglist
);

參數

[in] ComponentId

呼叫這個例程的元件。 此參數必須是 Dpfilter.h 中定義的其中一個元件名稱篩選標識碼。 若要避免將驅動程序的輸出與 Windows 元件的輸出混合，您應該只針對 ComponentId 使用下列值：

• DPFLTR_IHVVIDEO_ID
• DPFLTR_IHVAUDIO_ID
• DPFLTR_IHVNETWORK_ID
• DPFLTR_IHVSTREAMING_ID
• DPFLTR_IHVBUS_ID
• DPFLTR_IHVDRIVER_ID

[in] Level

正在傳送之訊息的嚴重性。 此參數可以是任何 32 位整數。 介於 0 到 31 (內含) 之間的值會以不同於 32 和 0xFFFFFFFF 之間的值。 如需如何處理值的詳細資訊，請參閱 讀取和篩選偵錯訊息。

[in] Format

要列印之格式字串的指標。 Format 字串支援大部分的 printf 樣式格式代碼。 不過，您可以使用 Unicode 格式代碼 (%C、 %S、 %lc、 %ls、 %wc、 %ws 和 %wZ) ，只有 IRQL = PASSIVE_LEVEL。 vDbgPrintEx 例程不支援 %f、%e、%E、%g、%G、%a 或 %A) 的任何浮點 (類型。

[in] arglist

格式字串的自變數清單。 vDbgPrintEx 例程會以與 vprintf 相同的方式使用此清單。

傳回值

如果作業成功，vDbgPrintEx 會傳回STATUS_SUCCESS。 否則，這個例程會傳回適當的錯誤碼。

備註

只有內核模式驅動程式可以呼叫 vDbgPrintEx 例程。

vDbgPrintEx 可以在 IRQL <= DIRQL 呼叫。 不過，您只能在 IRQL = PASSIVE_LEVEL 使用 Unicode 格式代碼 (%wc 和 %ws) 。 此外，由於調試程式使用進程間中斷 (IPI) 與其他處理器通訊，因此在 IRQL > DIRQL 呼叫 vDbgPrintEx 可能會導致死結。

vDbgPrintEx 會根據 ComponentId、 Level 和對應的元件篩選遮罩值，將它建立的字串傳遞給核心調試程式，或完全不執行任何動作。 如需 vDbgPrintEx 功能的詳細資訊，請參閱 讀取和篩選偵錯訊息。

除非絕對必要，否則您不應該從使用者輸入或其他進程取得字串，並將它傳遞至 vDbgPrintEx。 如果您使用未建立的字串，則必須確認此字串是有效的格式字串，而且格式代碼符合類型和數量中的自變數清單。 最佳程式代碼撰寫做法是讓所有 Format 字串都是靜態的，並在編譯時期定義。

Arglist 清單中的 Format 字串大小或自變數數目沒有上限。 不過， 任何對 vDbgPrintEx 的單一呼叫只會傳輸 512 個字節的資訊。

調試程式所使用的緩衝區大小也有限制。 如需此限制的詳細資訊，請參閱 DbgPrint 緩衝區和調試程式。

此例程定義於 Wdm.h 中。 元件篩選標識碼定義於 Dpfilter.h 中。

規格需求

另請參閱

DbgPrintEx