Freigeben über

WdfVerifierKeBugCheck-Funktion (wdfverifier.h)

  • Artikel

[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.hdefiniert 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

Nichts

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. Weitere Informationen finden Sie unter Erste Schritte mit WinDbg – Kernelmodus.

Wenn Ihr User-Mode Driver Framework (UMDF)-Treiber (Version 2.0 oder höher) WdfVerifierKeBugCheckaufruft, verwendet das Framework nicht die vom Treiber bereitgestellten Parameter. In diesem Fall wechselt das Framework in den Debugger, wenn eine verbindung besteht. Wenn kein Debugger verbunden ist, generiert das Framework eine Ausnahme, und der standardmäßige UMDF-Ausnahmehandler erstellt eine Minidumpdatei. Weitere Informationen zu unbehandelten Ausnahmen im Treiberhostprozess finden Sie unter How UMDF Reports Errors.

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

Beispiele

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

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

Anforderungen

Anforderung Wert
Zielplattform- Universal
Minimale KMDF-Version 1.0
Mindest-UMDF-Version 2.0
Header- wdfverifier.h (enthalten Wdf.h)
Library Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL- Beliebige Ebene
DDI-Complianceregeln DriverCreate(kmdf)

Siehe auch

WdfVerifierDbgBreakPoint-