WdfVerifierKeBugCheck 函式 (wdfverifier.h)

[適用於 KMDF 和 UMDF]

WdfVerifierKeBugCheck 函式會建立錯誤檢查。

語法

void WdfVerifierKeBugCheck(
  [in] ULONG     BugCheckCode,
  [in] ULONG_PTR BugCheckParameter1,
  [in] ULONG_PTR BugCheckParameter2,
  [in] ULONG_PTR BugCheckParameter3,
  [in] ULONG_PTR BugCheckParameter4
);

參數

[in] BugCheckCode

Bugcodes.h中定義的其中一個 錯誤檢查 碼。

[in] BugCheckParameter1

如需此參數的相關信息,請參閱指定的錯誤檢查程式代碼描述。

[in] BugCheckParameter2

如需此參數的相關信息,請參閱指定的錯誤檢查程式代碼描述。

[in] BugCheckParameter3

如需此參數的相關信息,請參閱指定的錯誤檢查程式代碼描述。

[in] BugCheckParameter4

如需此參數的相關信息,請參閱指定的錯誤檢查程式代碼描述。

傳回值

沒有

言論

如果您的 Kernel-Mode Driver Framework (KMDF) 驅動程式呼叫 WdfVerifierKeBugCheck,除非調試程式正在執行,否則操作系統會停止並顯示 藍螢幕。 如需詳細資訊,請參閱 開始使用 WinDbg - 核心模式

如果您的 User-Mode Driver Framework (UMDF) 驅動程式 (2.0 版或更新版本) 會呼叫 WdfVerifierKeBugCheck,則架構不會使用驅動程式所提供的參數。 在此情況下,如果已連接架構,架構就會中斷至調試程式。 如果調試程式未連線,架構會產生例外狀況,而預設的 UMDF 例外狀況處理程式會建立小型傾印檔案。 如需驅動程式主機程式中未處理例外狀況的詳細資訊,請參閱 UMDF 如何報告錯誤

如需偵錯驅動程式的詳細資訊,請參閱 偵錯 WDF 驅動程式

例子

下列程式代碼範例會建立使用 MULTIPLE_IRP_COMPLETE_REQUESTS 錯誤檢查程式代碼的錯誤檢查。

WdfVerifierKeBugCheck(
                      MULTIPLE_IRP_COMPLETE_REQUESTS,
                      (ULONG_PTR) irp,
                      (ULONG_PTR) srb,
                      0,
                      0
                      );

要求

要求 價值
目標平臺 普遍
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
標頭 wdfverifier.h (包括 Wdf.h)
連結庫 Wdf01000.sys (KMDF):WUDFx02000.dll (UMDF)
IRQL 任何層級
DDI 合規性規則 DriverCreate(kmdf)

另請參閱

WdfVerifierDbgBreakPoint