WdfVerifierKeBugCheck function (wdfverifier.h)

[Applies to KMDF and UMDF]

The WdfVerifierKeBugCheck function creates a bug check.

Syntax

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

Parameters

[in] BugCheckCode

One of the bug check codes that are defined in Bugcodes.h.

[in] BugCheckParameter1

For information about this parameter, see the specified bug check code's description.

[in] BugCheckParameter2

For information about this parameter, see the specified bug check code's description.

[in] BugCheckParameter3

For information about this parameter, see the specified bug check code's description.

[in] BugCheckParameter4

For information about this parameter, see the specified bug check code's description.

Return value

None

Remarks

If your Kernel-Mode Driver Framework (KMDF) driver calls WdfVerifierKeBugCheck, the operating system halts and displays a blue screen unless a debugger is running. For more information, see Getting Started with WinDbg - Kernel Mode.

If your User-Mode Driver Framework (UMDF) driver (version 2.0 or later) calls WdfVerifierKeBugCheck, the framework does not use the parameters that the driver supplies. In this case, the framework breaks into the debugger if one is connected. If a debugger is not connected, the framework generates an exception, and the default UMDF exception handler creates a minidump file. For more information about unhandled exceptions in the driver host process, see How UMDF Reports Errors.

For more information about debugging your driver, see Debugging WDF Drivers.

Examples

The following code example creates a bug check that uses the MULTIPLE_IRP_COMPLETE_REQUESTS bug check code.

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

Requirements

Requirement Value
Target Platform Universal
Minimum KMDF version 1.0
Minimum UMDF version 2.0
Header wdfverifier.h (include Wdf.h)
Library Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL Any level
DDI compliance rules DriverCreate(kmdf)

See also

WdfVerifierDbgBreakPoint