WdfVerifierKeBugCheck-Funktion (wdfverifier.h)

[Gilt für KMDF und UMDF]

Die WdfVerifierKeBugCheck-Funktion erstellt eine Fehlerüberprüfung.

Syntax

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

Parameter

[in] BugCheckCode

Einer der Fehlerüberprüfungscodes , die in Bugcodes.h definiert sind.

[in] BugCheckParameter1

Informationen zu diesem Parameter finden Sie in der Beschreibung des angegebenen Fehlerüberprüfungscodes.

[in] BugCheckParameter2

Informationen zu diesem Parameter finden Sie in der Beschreibung des angegebenen Fehlerüberprüfungscodes.

[in] BugCheckParameter3

Informationen zu diesem Parameter finden Sie in der Beschreibung des angegebenen Fehlerüberprüfungscodes.

[in] BugCheckParameter4

Informationen zu diesem Parameter finden Sie in der Beschreibung des angegebenen Fehlerüberprüfungscodes.

Rückgabewert

Keine

Bemerkungen

Wenn Ihr Kernel-Mode Driver Framework (KMDF)-Treiber WdfVerifierKeBugCheck aufruft, wird das Betriebssystem angehalten und zeigt einen blauen Bildschirm an , es sei denn, ein Debugger wird ausgeführt.

Wenn Ihr User-Mode Driver Framework (UMDF)-Treiber (Version 2.0 oder höher) WdfVerifierKeBugCheck aufruft, verwendet das Framework nicht die vom Treiber bereitgestellten Parameter. In diesem Fall bricht das Framework in den Debugger ein, wenn einer verbunden ist. Wenn ein Debugger nicht verbunden ist, generiert das Framework eine Ausnahme, und der STANDARD-UMDF-Ausnahmehandler erstellt eine Minidumpdatei. Weitere Informationen zu nicht behandelten Ausnahmen im Treiberhostprozess finden Sie unter So meldet UMDF Fehler.

Weitere Informationen zum Debuggen Ihres Treibers finden Sie unter Debuggen von WDF-Treibern.

Beispiele

Im folgenden Codebeispiel wird eine Fehlerüberprüfung erstellt, die den Code der MULTIPLE_IRP_COMPLETE_REQUESTS Fehlerüberprüfung verwendet.

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

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.0
UMDF-Mindestversion	2.0
Kopfzeile	wdfverifier.h (einschließen von Wdf.h)
Bibliothek	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	Beliebige Ebene
DDI-Complianceregeln	DriverCreate(kmdf)

Weitere Informationen

WdfVerifierDbgBreakPoint