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.

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