WdfVerifierDbgBreakPoint-Funktion (wdfverifier.h)

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

Siehe auch

WdfVerifierKeBugCheck-