WdfVerifierDbgBreakPoint-Funktion (wdfverifier.h)

Artikel
02/07/2025

[Gilt für KMDF und UMDF]

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

Syntax

void WdfVerifierDbgBreakPoint();

Rückgabewert

Nichts

Bemerkungen

Die WdfVerifierDbgBreakPoint--Funktion unterbricht in einen Kerneldebugger, wenn einer der folgenden Werte zutrifft:

DbgBreakOnError- auf einen Wert ungleich Null in der Registrierung festgelegt ist.
VerifierOn- wird auf einen Wert ungleich Null festgelegt, und DbgBreakOnError- nicht festgelegt ist.
Die Treiberüberprüfung ist aktiviert, der Treiber wurde mit framework Version 1.9 oder höher erstellt, und weder VerifierOn noch DbgBreakOnError- festgelegt ist.

Weitere Informationen zu Registrierungseinträgen, die Sie zum Debuggen des Treibers verwenden können, finden Sie unter Registrierungseinträge für das Debuggen Framework-Based Drivers.

Weitere Informationen zum Debuggen des 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-	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

WdfVerifierKeBugCheck-

Freigeben über