WdfVerifierDbgBreakPoint, fonction (wdfverifier.h)

Article
02/07/2025

[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

Aucun

Remarques

La fonction WdfVerifierDbgBreakPoint se décompose en un débogueur de noyau si l’une des valeurs suivantes est vraie :

DbgBreakOnError est défini sur une valeur différente de zéro dans le Registre.
De vérificateur est défini sur une valeur non nulle et DbgBreakOnError n’est pas définie.
Le vérificateur de pilotes est activé, le pilote a été créé avec framework version 1.9 ou ultérieure, et ni VerifierOn ni DbgBreakOnError est défini.

Pour plus d’informations sur les entrées de Registre que vous pouvez utiliser pour déboguer votre pilote, consultez Entrées de Registre pour le débogage Framework-Based Pilotes.

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;
}

Exigences

Exigence	Valeur
plateforme cible	Universel
version minimale de KMDF	1.0
version minimale de UMDF	2.0
d’en-tête	wdfverifier.h (include Wdf.h)
bibliothèque	Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF)
IRQL	N’importe quel niveau
règles de conformité DDI	DriverCreate(kmdf)

Voir aussi

WdfVerifierKeBugCheck

Partager via