WdfVerifierDbgBreakPoint, fonction (wdfverifier.h)
[S’applique à KMDF et UMDF]
La fonction WdfVerifierDbgBreakPoint se décompose en débogueur de noyau, si un débogueur est en cours d’exécution.
Syntaxe
void WdfVerifierDbgBreakPoint();
Valeur de retour
None
Remarques
La fonction WdfVerifierDbgBreakPoint se décompose en débogueur de noyau si l’une des conditions suivantes est vraie :
- DbgBreakOnError est défini sur une valeur différente de zéro dans le Registre.
- VerifierOn est défini sur une valeur différente de zéro et DbgBreakOnError n’est pas défini.
- Driver Verifier est activé, le pilote a été créé avec le framework version 1.9 ou ultérieure, et ni VerifierOn ni DbgBreakOnError ne sont définis.
Pour plus d’informations sur le débogage de votre pilote, consultez Débogage d’un pilote KMDF.
Exemples
L’exemple de code suivant montre comment un pilote peut gérer un échec d’obtention de la mémoire tampon de sortie d’une requête d’E/S.
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;
}
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| Version UMDF minimale | 2.0 |
| En-tête | wdfverifier.h (inclure Wdf.h) |
| Bibliothèque | Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF) |
| IRQL | N’importe quel niveau |
| Règles de conformité DDI | DriverCreate(kmdf) |