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