!analyze (WinDbg)
L’extension !analyze affiche des informations sur l’exception ou la vérification de bogue 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.
-Accrocher
Génère la sortie de l’application suspendue !analyze . Utilisez ce paramètre lorsque la cible a rencontré une vérification de bogue ou une exception. 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 des threads bloquent d’autres threads.
Avant d’exécuter cette extension en mode utilisateur, envisagez de remplacer le thread actuel par le thread qui, selon vous, a 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
-MontrerBugCheckCode[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 des bogues séparés par des espaces. Ces paramètres vous permettent d’affiner votre recherche.
Continuer les paramètres d’exécution
-c
Continue l’exécution lorsque le débogueur rencontre un problème connu. Si le problème n’est pas connu, le débogueur reste rompu à la 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. Tant que vous n’avez pas exécuté !analyze-c-load **** au moins une fois,!analyze-c n’a aucun effet.
-ChargeKnownIssuesFile
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 réutilisiez -c-load (auquel cas les nouvelles données remplacent les anciennes données).
-Décharger
Décharge la liste actuelle des problèmes connus.
-Aide
Affiche l’aide pour l’extension de commandes d’extension !analyze-c dans la fenêtre de commande Débogueur.
Paramètres de l’option de chargement XML
-Xml
Génère la sortie de l’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 appelle les trames de pile à la sortie xml. Cette option nécessite -xml ou -xmf.
-xmfOutputXmlFile
Écrit l’analyse dans le spécifié OutputXmlFile au format XML. Le fichier est remplacé s’il existe déjà. Aucune sortie d’analyse n’est générée dans la console ou le journal, sauf si l’option -xml est également spécifiée.
DLL
ext.dll
Informations supplémentaires
Pour obtenir un exemple d’analyse d’une exception en mode utilisateur et d’une erreur d’arrêt en mode noyau (c’est-à-dire un incident), 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 de bogue 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 voir 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 User-Mode Driver Framework (UMDF) version 2.15 ou ultérieure, !analyze fournit des informations sur les échecs du vérificateur UMDF et les exceptions non gérées. Cette fonctionnalité est disponible lors de l’exécution d’un débogage en mode noyau actif et lors de l’analyse d’un fichier de vidage de mémoire en mode utilisateur. Pour les incidents du pilote UMDF, !analyze tente d’identifier le pilote responsable.