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