IDebugClient2 ::WriteDumpFile, méthode (dbgeng.h)

Article
02/06/2025

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 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 de retour

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez valeurs de retour.

Retourner le code	Description
S_OK	La méthode a réussi.

Remarques

Les constantes DEBUG_DUMP_XXX sont utilisées par les méthodes WriteDumpFile, WriteDumpFile2et 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 petit vidage de mémoire (mode noyau) ou Minidump (mode utilisateur).
DEBUG_DUMP_DEFAULT	Crée un vidage complet User-Mode (mode utilisateur) ou un vidage de 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 des informations minidumps en mode utilisateur à 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.