!analyze (WinDbg)
L’extension !analyze affiche des informations sur l’exception ou la vérification des bogues en cours.
Mode utilisateur
!analyze [-v[0..99]] [-f | -hang]
!analyze [-v[0..99]] -xml [-xmi] [-xcs] [-xmf OutputXmlFile]
!analyze -c [-load KnownIssuesFile | -unload | -help ]
Mode noyau
!analyze [-v[0..99]] [-f | -hang]
!analyze -show BugCheckCode [BugParameters]
!analyze [-v[0..99]] -xml [-xmi] [-xcs] [-xmf OutputXmlFile]
!analyze -c [-load KnownIssuesFile | -unload | -help ]
Paramètres généraux
-v[0..99]
Affiche une sortie détaillée. Vous pouvez afficher plus d’informations en spécifiant un nombre compris entre 0 et 99. Si vous ne spécifiez pas de nombre, la valeur par défaut est 1. Vous pouvez également spécifier very Verbose (-vv) pour afficher toutes les informations disponibles.
Pour le mode utilisateur, -v6 affiche ce qui a été découvert globalement et sur chaque thread.
-f
Génère la sortie de l’exception !analyze . Utilisez ce paramètre pour afficher une analyse d’exception même lorsque le débogueur ne détecte pas d’exception.
-pendre
Génère !analyser la sortie de l’application suspendue. Utilisez ce paramètre lorsque la cible a rencontré une vérification ou une exception de bogue. Toutefois, une analyse de la raison pour laquelle une application est bloquée est plus pertinente pour votre problème. En mode noyau, !analyze -hang examine les verrous que le système contient, puis analyse la chaîne de file d’attente DPC. En mode utilisateur, !analyze -hang analyse la pile de threads pour déterminer si les threads bloquent d’autres threads.
Avant d’exécuter cette extension en mode utilisateur, envisagez de modifier le thread actuel sur le thread que vous pensez avoir cessé de répondre (c’est-à-dire suspendu). Vous devez effectuer cette modification, car l’exception a peut-être modifié le thread actuel en un autre.
Afficher le paramètre
-montrer BugCheckCode [BugParameters]
Affiche des informations sur la vérification des bogues spécifiée par BugCheckCode. BugParameters spécifie jusqu’à quatre paramètres de vérification de bogue séparés par des espaces. Ces paramètres vous permettent d’affiner davantage votre recherche.
Continuer les paramètres d’exécution
-c
Poursuit l’exécution lorsque le débogueur rencontre un problème connu. Si le problème n’est pas connu, le débogueur reste divisé en cible.
Vous pouvez utiliser l’option -c avec les sous-paramètres suivants. Ces sous-paramètres configurent la liste des problèmes connus. Ils ne provoquent pas l’exécution par eux-mêmes. Jusqu’à ce que vous exécutez !analyze -c-load **** au moins une fois, !analyze -c n’a aucun effet.
-charger KnownIssuesFile
Charge le fichier de problèmes connus spécifié. KnownIssuesFile spécifie le chemin d’accès et le nom de fichier de ce fichier. Ce fichier doit être au format XML.
La liste des problèmes connus dans le KnownIssuesFile fichier est utilisée pour toutes les commandes -c ultérieures jusqu’à ce que vous utilisiez -c -unload, ou jusqu’à ce que vous utilisiez à nouveau -c -load (à quel moment les nouvelles données remplacent les anciennes données).
-décharger
Décharge la liste actuelle des problèmes connus.
-help
Affiche l’aide pour l’extension des commandes d’extension !analyze -c dans la fenêtre de commande du débogueur.
Paramètres d’option de chargement XML
-xml
Génère la sortie d’analyse au format XML.
-Xmi
Ajoute des informations de module à la sortie xml. Cette option nécessite -xml ou -xmf.
-xcs
Ajoute le contexte et les trames de pile d’appel à la sortie xml. Cette option nécessite -xml ou -xmf.
-xmf OutputXmlFile
Écrit l’analyse au format XML spécifié OutputXmlFile . Le fichier est remplacé, s’il existe déjà. Aucune sortie d’analyse n’est générée dans la console ou dans le journal, sauf si l’option -xml est également spécifiée.
DLL
ext.dll
Informations supplémentaires
Pour obtenir des exemples d’analyse d’une exception en mode utilisateur et d’une erreur d’arrêt en mode noyau (autrement dit, plantage), et pour plus d’informations sur la façon dont !analyze utilise le fichier triage.ini, consultez Utilisation de l’extension !analyze.
Notes
En mode utilisateur, !analyze affiche des informations sur l’exception actuelle.
En mode noyau, !analyze affiche des informations sur la vérification des bogues la plus récente. Si une vérification de bogue se produit, l’affichage !analyze est généré automatiquement. Vous pouvez utiliser !analyze -v pour afficher des informations supplémentaires. Si vous souhaitez afficher uniquement les paramètres de vérification des bogues de base, vous pouvez utiliser la commande .bugcheck (afficher les données de vérification des bogues).
Pour les pilotes qui utilisent UMDF (User-Mode Driver Framework) version 2.15 ou ultérieure, !analyze fournit des informations sur les échecs de vérificateur UMDF et les exceptions non gérées. Cette fonctionnalité est disponible lors de l’exécution du débogage en mode noyau actif et lors de l’analyse d’un fichier de vidage mémoire en mode utilisateur. Pour les blocages du pilote UMDF, !analysez les tentatives d’identification du pilote responsable.