IDebugClient2::WriteDumpFile-Methode (dbgeng.h)

Artikel
02/23/2024

Die WriteDumpFile-Methode erstellt eine Benutzermodus- oder kernel-modecrash-Dumpdatei.

Syntax

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

Parameter

[in] DumpFile

Gibt den Namen der zu erstellenden Dumpdatei an. DumpFile muss die Dateinamenerweiterung enthalten. DumpFile kann einen relativen oder absoluten Pfad enthalten. relative Pfade sind relativ zum Verzeichnis, in dem der Debugger gestartet wurde.

[in] Qualifier

Gibt den Typ der zu erstellenden Dumpdatei an. Mögliche Werte finden Sie unter Hinweise.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.

Hinweise

Die DEBUG_DUMP_XXX-Konstanten werden von den Methoden WriteDumpFile, WriteDumpFile2 und WriteDumpFileWide verwendet, um den Typ der zu erstellenden Absturzabbilddatei anzugeben.

Folgende Werte sind möglich.

Dauerhaft	BESCHREIBUNG
DEBUG_DUMP_SMALL	Erstellt ein kleines Speicherabbild (Kernelmodus) oder Minidump (Benutzermodus).
DEBUG_DUMP_DEFAULT	Erstellt ein vollständiges User-Mode-Dump (Benutzermodus) oder kernelzusammenfassungsabbild (Kernelmodus).
DEBUG_DUMP_FULL	Erstellt ein vollständiges Speicherabbild (nur Kernelmodus).

Verwenden Sie WriteDumpFile2 oder WriteDumpWide, um die Formatierung der Datei und - für Minidumps im Benutzermodus - die Informationen anzugeben, die in die Datei eingeschlossen werden sollen.

Weitere Informationen zu Absturzabbilddateien finden Sie unter Dump-File Targets.

Darüber hinaus sind die folgenden Aliase für das Debuggen im Kernelmodus verfügbar.

Alias	Wert
DEBUG_KERNEL_SMALL_DUMP	DEBUG_DUMP_SMALL
DEBUG_KERNEL_DUMP	DEBUG_DUMP_DEFAULT
DEBUG_KERNEL_FULL_DUMP	DEBUG_DUMP_FULL

Darüber hinaus sind die folgenden Aliase für das Debuggen im Benutzermodus verfügbar.

Alias	Wert
DEBUG_USER_WINDOWS_SMALL_DUMP	DEBUG_DUMP_SMALL
DEBUG_USER_WINDOWS_DUMP	DEBUG_DUMP_DEFAULT

Eine Beschreibung der Kernelmodusdumpdateien finden Sie unter Sorten von Kernel-Mode Dumpdateien. Eine Beschreibung der Abbilddateien im Benutzermodus finden Sie unter Sorten von User-Mode-Dumpdateien.