Metodo IDebugClient::WriteDumpFile (dbgeng.h)

Articolo
02/23/2024

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 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 altre informazioni, vedere Valori restituiti .

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.

Commenti

Le costanti DEBUG_DUMP_XXX vengono usate dai metodi WriteDumpFile, WriteDumpFile2 e WriteDumpFileWide per specificare il tipo di file di dump di arresto anomalo da creare.

I valori possibili includono quanto segue.

Costante	Descrizione
DEBUG_DUMP_SMALL	Crea un dump di memoria piccola (modalità kernel) o Minidump (modalità utente).
DEBUG_DUMP_DEFAULT	Crea un dump completo User-Mode (modalità utente) o dump di riepilogo del kernel (modalità kernel).
DEBUG_DUMP_FULL	Crea un dump di memoria completo (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, vedere Destinazioni dump-file.

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.