WdfVerifierDbgBreakPoint 函式 (wdfverifier.h)

  • 發行項

[適用於 KMDF 和 UMDF]

如果調試程式正在執行， WdfVerifierDbgBreakPoint 函式會中斷為核心調試程式。

Syntax

void WdfVerifierDbgBreakPoint();

傳回值

無

備註

如果下列其中一項成立， WdfVerifierDbgBreakPoint 函式會中斷為核心調試程式：

  • DbgBreakOnError 會設定為登錄中的非零值。
  • VerifierOn 設定為非零值，且未設定 DbgBreakOnError 。
  • 驅動程式驗證器已啟用、驅動程式是使用架構 1.9 版或更新版本所建置，而且不會設定 VerifierOn 或 DbgBreakOnError 。
如需可用來偵錯驅動程式之登錄專案的詳細資訊，請參閱偵錯 Framework-Based 驅動程式的登錄專案。

如需偵錯驅動程式的詳細資訊，請參閱 對 KMDF 驅動程式進行偵錯。

範例

下列程式代碼範例示範驅動程式如何處理無法取得 I/O 要求的輸出緩衝區。

Status = WdfRequestRetrieveOutputMemory(
                                        Request,
                                        &memory
                                        );
if( !NT_SUCCESS(Status) ) {
    KdPrint(("EvtIoRead could not get request memory buffer. Status: 0x%x\n",Status));
    WdfVerifierDbgBreakPoint();
    WdfRequestCompleteWithInformation(
                                      Request,
                                      Status,
                                      0L
                                      );
    return;
}

規格需求

需求 值
目標平台 Universal
最低 KMDF 版本 1.0
最低UMDF版本 2.0
標頭 wdfverifier.h (包含 Wdf.h)
程式庫 Wdf01000.sys (KMDF) ;WUDFx02000.dll (UMDF)
IRQL 任何層級
DDI 合規性規則 DriverCreate (kmdf)

另請參閱

WdfVerifierKeBugCheck