WdfVerifierKeBugCheck function

[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

BugCheckCode [in]

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

BugCheckParameter1 [in]

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

BugCheckParameter2 [in]

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

BugCheckParameter3 [in]

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

BugCheckParameter4 [in]

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

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

See also

WdfVerifierDbgBreakPoint

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft