Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | dbgeng.h (include Dbgeng.h) |