IDebugClient4::WriteDumpFile-Methode (dbgeng.h)

Artikel
02/23/2024

Die WriteDumpFile-Methode erstellt eine Dumpdatei für den Benutzermodus oder kernel-modecrash.

Syntax

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

Parameter

[in] DumpFile

Gibt den Namen der zu erstellenden Speicherabbilddatei 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 Speicherabbilddatei an. Mögliche Werte finden Sie unter Hinweise.

Rückgabewert

Diese Methode gibt möglicherweise auch Fehlerwerte zurück. 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.

Die möglichen Werte umfassen Folgendes.

Dauerhaft	BESCHREIBUNG
DEBUG_DUMP_SMALL	Erstellt einen kleinen Speicherabbild (Kernelmodus) oder Minidump (Benutzermodus).
DEBUG_DUMP_DEFAULT	Erstellt ein vollständiges User-Mode-Speicherabbild (Benutzermodus) oder ein Kernelzusammenfassungsabbild (Kernelmodus).
DEBUG_DUMP_FULL	Erstellt ein vollständiges Speicherabbild (nur Kernelmodus).

Verwenden Sie WriteDumpFile2 oder WriteDumpFileWide, um die Formatierung der Datei und - für Minidumps im Benutzermodus - anzugeben.

Weitere Informationen zu Absturzabbilddateien finden Sie unter Speicherabbilddateiziele.

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 Speicherabbilddateien im Kernelmodus finden Sie unter Sorten von Kernel-Mode Dumpdateien. Eine Beschreibung der Speicherabbilddateien im Benutzermodus finden Sie unter Sorten von User-Mode Dumpdateien.