Méthode IDebugClient4 ::WriteDumpFile (dbgeng.h)

Article
08/07/2023

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
S_OK	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.