Metodo IDebugClient5::WriteDumpFile (dbgeng.h)

Articolo
02/06/2025

Il metodo WriteDumpFile crea un file dump in modalità utente o kernel-modecrash.

Sintassi

HRESULT WriteDumpFile(
  [in] PCSTR DumpFile,
  [in] ULONG Qualifier
);

Parametri

[in] DumpFile

Specifica il nome del file di dump da creare. DumpFile deve includere l'estensione del nome file. DumpFile può includere un percorso relativo o assoluto; i percorsi relativi sono relativi alla directory in cui è stato avviato il debugger.

[in] Qualifier

Specifica il tipo di file di dump da creare. Per i valori possibili, vedere Osservazioni.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere valori restituiti.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.

Osservazioni

Le costantiDEBUG_DUMP_ XXX vengono utilizzate dai metodi WriteDumpFile, WriteDumpFile2e WriteDumpFileWide per specificare il tipo di file di dump di arresto anomalo del sistema da creare.

I valori possibili includono quanto segue.

Costante	Descrizione
DEBUG_DUMP_SMALL	Crea un piccolo dump della memoria (modalità kernel) o Minidump (modalità utente).
DEBUG_DUMP_DEFAULT	Crea un dump completo User-Mode (modalità utente) o un dump di riepilogo del kernel (modalità kernel).
DEBUG_DUMP_FULL	Crea un dump completo della memoria (solo in modalità kernel).

Per specificare la formattazione del file e-per minidumps in modalità utente, le informazioni da includere nel file, usare WriteDumpFile2 o WriteDumpFileWide.

Per altre informazioni sui file di dump di arresto anomalo del sistema, vedere Dump-File Destinazioni.

Inoltre, gli alias seguenti sono disponibili per il debug in modalità kernel.

Alias	Valore
DEBUG_KERNEL_SMALL_DUMP	DEBUG_DUMP_SMALL
DEBUG_KERNEL_DUMP	DEBUG_DUMP_DEFAULT
DEBUG_KERNEL_FULL_DUMP	DEBUG_DUMP_FULL

Inoltre, gli alias seguenti sono disponibili per il debug in modalità utente.

Alias	Valore
DEBUG_USER_WINDOWS_SMALL_DUMP	DEBUG_DUMP_SMALL
DEBUG_USER_WINDOWS_DUMP	DEBUG_DUMP_DEFAULT

Per una descrizione dei file di dump in modalità kernel, vedere varietà di file di dump Kernel-Mode. Per una descrizione dei file di dump in modalità utente, vedere varietà di file di dump User-Mode.