IDebugClient::WriteDumpFile-Methode (dbgeng.h)

Artikel
02/06/2025

Die WriteDumpFile--Methode erstellt eine Speicherabbilddatei für den Benutzermodus oder kernelmoduscrash.

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 in den Anmerkungen.

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.

Bemerkungen

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

Die möglichen Werte umfassen Folgendes.

Konstante	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 WriteDumpFileWide-, um die Formatierung der Datei und -für den Benutzermodus-Minidumps anzugeben.

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

Darüber hinaus stehen die folgenden Aliase für das Debuggen im Kernelmodus zur Verfügung.

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 stehen die folgenden Aliase für das Debuggen im Benutzermodus zur Verfügung.

Alias	Wert
DEBUG_USER_WINDOWS_SMALL_DUMP	DEBUG_DUMP_SMALL
DEBUG_USER_WINDOWS_DUMP	DEBUG_DUMP_DEFAULT

Eine Beschreibung der Kernelmodus-Dumpdateien finden Sie unter Sorten von Kernel-Mode Dumpdateien. Eine Beschreibung der Abbilddateien für den Benutzermodus finden Sie unter Sorten von User-Mode Dumpdateien.