WdfVerifierDbgBreakPoint-Funktion (wdfverifier.h)

[Gilt für KMDF und UMDF]

Die WdfVerifierDbgBreakPoint-Funktion wird in einen Kerneldebugger unterteilt, wenn ein Debugger ausgeführt wird.

Syntax

void WdfVerifierDbgBreakPoint();

Rückgabewert

Keine

Bemerkungen

Die WdfVerifierDbgBreakPoint-Funktion wird in einen Kerneldebugger unterteilt, wenn einer der folgenden Punkte zutrifft:

  • DbgBreakOnError wird in der Registrierung auf einen Wert ungleich 0 festgelegt.
  • VerifierOn ist auf einen Wert ungleich 0 festgelegt, und DbgBreakOnError ist nicht festgelegt.
  • Die Treiberüberprüfung ist aktiviert, der Treiber wurde mit Frameworkversion 1.9 oder höher erstellt, und weder VerifierOn noch DbgBreakOnError ist festgelegt.
Weitere Informationen zu Registrierungseinträgen, die Sie zum Debuggen Ihres Treibers verwenden können, finden Sie unter Registrierungseinträge für das Debuggen Framework-Based Treiber.

Weitere Informationen zum Debuggen Ihres Treibers finden Sie unter Debuggen eines KMDF-Treibers.

Beispiele

Das folgende Codebeispiel zeigt, wie ein Treiber einen Fehler beim Abrufen des Ausgabepuffers einer E/A-Anforderung behandeln kann.

Status = WdfRequestRetrieveOutputMemory(
                                        Request,
                                        &memory
                                        );
if( !NT_SUCCESS(Status) ) {
    KdPrint(("EvtIoRead could not get request memory buffer. Status: 0x%x\n",Status));
    WdfVerifierDbgBreakPoint();
    WdfRequestCompleteWithInformation(
                                      Request,
                                      Status,
                                      0L
                                      );
    return;
}

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

WdfVerifierKeBugCheck