Partager via

WdfVerifierKeBugCheck, fonction (wdfverifier.h)

  • Article

[S’applique à KMDF et UMDF]

La fonction WdfVerifierKeBugCheck crée une vérification de bogue.

Syntaxe

void WdfVerifierKeBugCheck(
  [in] ULONG     BugCheckCode,
  [in] ULONG_PTR BugCheckParameter1,
  [in] ULONG_PTR BugCheckParameter2,
  [in] ULONG_PTR BugCheckParameter3,
  [in] ULONG_PTR BugCheckParameter4
);

Paramètres

[in] BugCheckCode

L’un des codes de vérification des bogues définis dans Bugcodes.h.

[in] BugCheckParameter1

Pour plus d’informations sur ce paramètre, consultez la description du code de vérification des bogues spécifié.

[in] BugCheckParameter2

Pour plus d’informations sur ce paramètre, consultez la description du code de vérification des bogues spécifié.

[in] BugCheckParameter3

Pour plus d’informations sur ce paramètre, consultez la description du code de vérification des bogues spécifié.

[in] BugCheckParameter4

Pour plus d’informations sur ce paramètre, consultez la description du code de vérification des bogues spécifié.

Valeur de retour

Aucun

Remarques

Si votre pilote KMDF (Kernel-Mode Driver Framework) appelle WdfVerifierKeBugCheck, le système d’exploitation s’arrête et affiche un écran bleu , sauf si un débogueur est en cours d’exécution. Pour plus d’informations, consultez Prise en main de WinDbg - Mode noyau.

Si votre pilote UMDF (User-Mode Driver Framework) (version 2.0 ou ultérieure) appelle WdfVerifierKeBugCheck, l’infrastructure n’utilise pas les paramètres que le pilote fournit. Dans ce cas, le framework se décompose dans le débogueur si celui-ci est connecté. Si un débogueur n’est pas connecté, l’infrastructure génère une exception et le gestionnaire d’exceptions UMDF par défaut crée un fichier minidump. Pour plus d’informations sur les exceptions non gérées dans le processus hôte du pilote, consultez Comment UMDF signale des erreurs.

Pour plus d’informations sur le débogage de votre pilote, consultez Débogage de pilotes WDF.

Exemples

L’exemple de code suivant crée une vérification de bogue qui utilise le code de vérification des bogues MULTIPLE_IRP_COMPLETE_REQUESTS.

WdfVerifierKeBugCheck(
                      MULTIPLE_IRP_COMPLETE_REQUESTS,
                      (ULONG_PTR) irp,
                      (ULONG_PTR) srb,
                      0,
                      0
                      );

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

WdfVerifierDbgBreakPoint