IDebugClient3::WriteDumpFile2-Methode (dbgeng.h)

Artikel
02/06/2025

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

Syntax

HRESULT WriteDumpFile2(
  [in]           PCSTR DumpFile,
  [in]           ULONG Qualifier,
  [in]           ULONG FormatFlags,
  [in, optional] PCSTR Comment
);

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 DEBUG_DUMP_XXX.

[in] FormatFlags

Gibt Flags an, die das Format der Speicherabbilddatei und -für den Benutzermodus-Minidumps bestimmen, welche Informationen in die Datei eingeschlossen werden sollen. Ausführliche Informationen finden Sie in den Hinweisen.

[in, optional] Comment

Gibt eine Kommentarzeichenfolge an, die in die Absturzabbilddatei aufgenommen werden soll. Diese Zeichenfolge wird in der Debuggerkonsole angezeigt, wenn die Speicherabbilddatei geladen wird. Einige Speicherabbilddateiformate unterstützen das Speichern von Kommentarzeichenfolgen nicht.

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_FORMAT_XXX- Bit-Flags werden von WriteDumpFile2 und WriteDumpFileWide verwendet, um das Format einer Absturzabbilddatei und für Minidumps im Benutzermodus zu bestimmen, welche Informationen in die Datei eingeschlossen werden sollen.

Die folgenden Bitkennzeichnungen gelten für alle Absturzabbilddateien.

Wert	Beschreibung
DEBUG_FORMAT_WRITE_CAB	Packen Sie die Absturzabbilddatei in einer CAB-Datei. Der angegebene Dateiname oder Dateihandle wird für die CAB-Datei verwendet; Das Absturzabbild wird zuerst in einer temporären Datei erstellt, bevor sie in die CAB-Datei verschoben wird.
DEBUG_FORMAT_CAB_SECONDARY_FILES	Fügen Sie die aktuellen Symbole und zugeordneten Bilder in die CAB-Datei ein. Wenn DEBUG_FORMAT_WRITE_CAB nicht festgelegt ist, wird dieses Flag ignoriert.
DEBUG_FORMAT_NO_OVERWRITE	Vorhandene Dateien nicht überschreiben.

Die folgenden Bit-Flags können auch für Minidumps für den Benutzermodus enthalten sein.

Wert	Beschreibung
DEBUG_FORMAT_USER_SMALL_FULL_MEMORY	Fügen Sie vollständige Speicherdaten hinzu. Alle barrierefreien zugesicherten Seiten, die der Zielanwendung gehören, werden einbezogen.
DEBUG_FORMAT_USER_SMALL_HANDLE_DATA	Fügen Sie Daten zu den Handles hinzu, die der Zielanwendung zugeordnet sind.
DEBUG_FORMAT_USER_SMALL_UNLOADED_MODULES	Fügen Sie ungeladene Modulinformationen hinzu. Diese Informationen sind nur in Windows Server 2003 und höheren Versionen von Windows verfügbar.
DEBUG_FORMAT_USER_SMALL_INDIRECT_MEMORY	Fügen Sie indirekten Speicher hinzu. Ein kleiner Speicherbereich, der jede Adresse umgibt, auf die von einem Zeiger im Stapel- oder Sicherungsspeicher verwiesen wird, ist enthalten.
DEBUG_FORMAT_USER_SMALL_DATA_SEGMENTS	Fügen Sie alle Datensegmente innerhalb der ausführbaren Bilder hinzu.
DEBUG_FORMAT_USER_SMALL_FILTER_MEMORY	Legen Sie den gesamten Speicher des Stapels und im Sicherungsspeicher auf Null fest, der für die Neuerstellung der Stapelablaufverfolgung nicht hilfreich ist. Dies kann die Komprimierung des Minidumps effizienter machen und den Datenschutz erhöhen, indem unnötige Informationen entfernt werden.
DEBUG_FORMAT_USER_SMALL_FILTER_PATHS	Entfernen Sie die Modulpfade, wobei nur die Modulnamen verbleiben. Dies ist nützlich für den Schutz der Privatsphäre, indem die Verzeichnisstruktur ausgeblendet wird (die den Namen des Benutzers enthalten kann).
DEBUG_FORMAT_USER_SMALL_PROCESS_THREAD_DATA	Fügen Sie den Prozessumgebungsblock (PROCESS Environment Block, PEB) und den Threadumgebungsblock (THREAD Environment Block, TEB) hinzu. Dieses Kennzeichen kann verwendet werden, um Windows-Systeminformationen für Threads und Prozesse bereitzustellen.
DEBUG_FORMAT_USER_SMALL_PRIVATE_READ_WRITE_MEMORY	Fügen Sie alle zugesicherten privaten Lese-/Schreibzugriffsspeicherseiten hinzu.
DEBUG_FORMAT_USER_SMALL_NO_OPTIONAL_DATA	Verhindern, dass datenschutzrelevante Daten in den Minidump aufgenommen werden. Derzeit schließt dieses Flag aus den Minidump-Daten aus, die aufgrund der folgenden Kennzeichen hinzugefügt wurden, die festgelegt werden: DEBUG_FORMAT_USER_SMALL_PROCESS_THREAD_DATA, DEBUG_FORMAT_USER_SMALL_FULL_MEMORY, DEBUG_FORMAT_USER_SMALL_INDIRECT_MEMORY, DEBUG_FORMAT_USER_SMALL_PRIVATE_READ_WRITE_MEMORY.
DEBUG_FORMAT_USER_SMALL_FULL_MEMORY_INFO	Fügen Sie alle grundlegenden Speicherinformationen hinzu. Dies sind die Informationen, die von der QueryVirtual--Methode zurückgegeben werden. Die Informationen für den gesamten Arbeitsspeicher sind enthalten, nicht nur gültiger Arbeitsspeicher, wodurch der Debugger das vollständige virtuelle Speicherlayout aus dem Minidump rekonstruieren kann.
DEBUG_FORMAT_USER_SMALL_THREAD_INFO	Fügen Sie zusätzliche Threadinformationen hinzu, einschließlich Ausführungszeit, Startzeit, Beendigungszeit, Startadresse und Beendigungsstatus.
DEBUG_FORMAT_USER_SMALL_CODE_SEGMENTS	Fügen Sie alle Codesegmente mit den ausführbaren Bildern hinzu.