Méthode IDebugClient3 ::WriteDumpFile (dbgeng.h)
La méthode WriteDumpFile crée un fichier de vidage en mode utilisateur ou en mode noyaucrash.
Syntaxe
HRESULT WriteDumpFile(
[in] PCSTR DumpFile,
[in] ULONG Qualifier
);
Paramètres
[in] DumpFile
Spécifie le nom du fichier de vidage à créer. DumpFile doit inclure l’extension de nom de fichier. DumpFile peut inclure un chemin d’accès relatif ou absolu ; les chemins relatifs sont relatifs au répertoire dans lequel le débogueur a été démarré.
[in] Qualifier
Spécifie le type de fichier de vidage à créer. Pour connaître les valeurs possibles, consultez Remarques.
Valeur retournée
Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez Valeurs de retour.
Code de retour | Description |
---|---|
|
La méthode a réussi. |
Remarques
Les constantes DEBUG_DUMP_XXX sont utilisées par les méthodes WriteDumpFile, WriteDumpFile2 et WriteDumpFileWide pour spécifier le type de fichier de vidage sur incident à créer.
Les valeurs possibles sont les suivantes.
Constant | Description |
---|---|
DEBUG_DUMP_SMALL | Crée un vidage de mémoire de petite taille (mode noyau) ou minidump (mode utilisateur). |
DEBUG_DUMP_DEFAULT | Crée un vidage complet User-Mode (mode utilisateur) ou un vidage résumé du noyau (mode noyau). |
DEBUG_DUMP_FULL |
Crée un vidage de mémoire complet (mode noyau uniquement). |
Pour spécifier la mise en forme du fichier et, pour les minidumps en mode utilisateur, les informations à inclure dans le fichier, utilisez WriteDumpFile2 ou WriteDumpFileWide.
Pour plus d’informations sur les fichiers de vidage sur incident, consultez Dump-File Targets.
En outre, les alias suivants sont disponibles pour le débogage en mode noyau.
Alias | Valeur |
---|---|
DEBUG_KERNEL_SMALL_DUMP | DEBUG_DUMP_SMALL |
DEBUG_KERNEL_DUMP | DEBUG_DUMP_DEFAULT |
DEBUG_KERNEL_FULL_DUMP | DEBUG_DUMP_FULL |
En outre, les alias suivants sont disponibles pour le débogage en mode utilisateur.
Alias | Valeur |
---|---|
DEBUG_USER_WINDOWS_SMALL_DUMP | DEBUG_DUMP_SMALL |
DEBUG_USER_WINDOWS_DUMP | DEBUG_DUMP_DEFAULT |
Pour obtenir une description des fichiers de vidage en mode noyau, consultez Variétés de fichiers de vidage Kernel-Mode. Pour obtenir une description des fichiers de vidage en mode utilisateur, consultez Variétés de fichiers de vidage User-Mode.
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Desktop (Expérience utilisateur) |
En-tête | dbgeng.h (inclure Dbgeng.h) |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour