MINIDUMP_CALLBACK_TYPE-Enumeration (minidumpapiset.h)

  • Artikel

Gibt den Typ der Von der MiniDumpCallback-Funktion zurückgegebenen Informationen an. Nicht alle Speicherfehler führen zu einem Rückruf. Wenn sich der Fehler z. B. innerhalb eines Stapels befindet, wird der Fehler als nicht behebbar betrachtet, und der Minidump schlägt fehl.

Syntax

typedef enum _MINIDUMP_CALLBACK_TYPE {
  ModuleCallback,
  ThreadCallback,
  ThreadExCallback,
  IncludeThreadCallback,
  IncludeModuleCallback,
  MemoryCallback,
  CancelCallback,
  WriteKernelMinidumpCallback,
  KernelMinidumpStatusCallback,
  RemoveMemoryCallback,
  IncludeVmRegionCallback,
  IoStartCallback,
  IoWriteAllCallback,
  IoFinishCallback,
  ReadMemoryFailureCallback,
  SecondaryFlagsCallback,
  IsProcessSnapshotCallback,
  VmStartCallback,
  VmQueryCallback,
  VmPreReadCallback,
  VmPostReadCallback
} MINIDUMP_CALLBACK_TYPE;

Konstanten

 
ModuleCallback
Die Rückruffunktion gibt Modulinformationen zurück.
ThreadCallback
Die Rückruffunktion gibt Threadinformationen zurück.
ThreadExCallback
Die Rückruffunktion gibt erweiterte Threadinformationen zurück.
IncludeThreadCallback
Die Rückruffunktion gibt an, welche Threads eingeschlossen werden sollen. Sie wird aufgerufen, da die Minidump-Bibliothek
Aufzählen der Threads in einem Prozess statt nach den gesammelten Informationen, wie bei
ThreadCallback oder ThreadExCallback. Es wird aufgerufen,
jeder Thread. Wenn die Rückruffunktion FALSE zurückgibt, wird der aktuelle Thread ausgeschlossen.
Dadurch kann der Aufrufer Informationen für eine Teilmenge der Threads in einem Prozess abrufen, ohne angehalten zu werden.
Threads, die nicht von Interesse sind. Alternativ können Sie threadWriteFlags ändern.
Mitglied des MINIDUMP_CALLBACK_OUTPUT
strukturieren und true zurückgeben, um das Sammeln unnötiger Informationen für die
ausgeführt werden müssen.
IncludeModuleCallback
Die Rückruffunktion gibt an, welche Module eingeschlossen werden sollen. Die Rückruffunktion wird als aufgerufen.
die Minidump-Bibliothek listet die Module in einem Prozess auf, anstatt nach dem Sammeln der Informationen, da sie
ist mit ModuleCallback. Sie wird für jedes Modul aufgerufen. Wenn die Rückruffunktion
gibt FALSE zurück, das aktuelle Modul ist ausgeschlossen. Alternativ können Sie die
ModuleWriteFlags-Element des
MINIDUMP_CALLBACK_OUTPUT Struktur und
gibt TRUE zurück, um das Sammeln unnötiger Informationen für das Modul zu vermeiden.
MemoryCallback
Die Rückruffunktion gibt einen Speicherbereich zurück, der in das Speicherabbild eingeschlossen werden soll. Der Rückruf wird nur aufgerufen.
für Dumps, die ohne das MiniDumpWithFullMemory-Flag generiert werden. Wenn die Rückruffunktion zurückgibt
FALSE oder ein Bereich der Größe 0, der Rückruf wird nicht erneut aufgerufen.


DbgHelp 6.1 und früher: Dieser Wert wird nicht unterstützt.
CancelCallback
Die Rückruffunktion gibt Abbruchinformationen zurück.


DbgHelp 6.1 und früher: Dieser Wert wird nicht unterstützt.
WriteKernelMinidumpCallback
Der Minidump für den Benutzermodus wurde erfolgreich abgeschlossen. Um einen Kernelmodus-Minidump zu initiieren, den Rückruf
sollte TRUE zurückgeben und das Handle-Element der
MINIDUMP_CALLBACK_OUTPUT Struktur.


DbgHelp 6.1 und früher: Dieser Wert wird nicht unterstützt.
KernelMinidumpStatusCallback
Die Rückruffunktion gibt status Informationen für den Kernel-Minidump zurück.


DbgHelp 6.1 und früher: Dieser Wert wird nicht unterstützt.
RemoveMemoryCallback
Die Rückruffunktion gibt einen Speicherbereich zurück, der aus dem Speicherabbild ausgeschlossen werden soll. Der Rückruf wird nur aufgerufen.
für Dumps, die ohne das MiniDumpWithFullMemory-Flag generiert werden. If the callback
die Funktion gibt FALSE zurück, oder ein Bereich der Größe 0, der Rückruf wird nicht erneut aufgerufen.


DbgHelp 6.3 und früher: Dieser Wert wird nicht unterstützt.
IncludeVmRegionCallback
Die Rückruffunktion gibt Informationen zum virtuellen Speicherbereich zurück. Es wird zweimal für jede aufgerufen.
region während des Schreibdurchlaufs mit vollem Arbeitsspeicher. Das VmRegion-Element des
MINIDUMP_CALLBACK_OUTPUT-Struktur
enthält den aktuellen Speicherbereich. Sie können die Basisadresse und die Größe der Region ändern, solange die neue
region bleibt eine Teilmenge der ursprünglichen Region; Änderungen an anderen Membern werden ignoriert. Wenn der Rückruf zurückgibt
TRUE und legt den Member Continue von fest.
MINIDUMP_CALLBACK_OUTPUT an
TRUE, verwendet die Minidump-Bibliothek den durch angegebenen Bereich.
VmRegion als zu schreibende Region. Wenn der Rückruf zurückgibt
FALSE oder , wenn Continueden Wert FALSE aufweist,
Der Rückruf wird für zusätzliche Speicherbereiche nicht aufgerufen.


DbgHelp 6.4 und früher: Dieser Wert wird nicht unterstützt.
IoStartCallback
Die Rückruffunktion gibt an, dass der Aufrufer eine alternative E/A-Routine bereitstellt. If the callback
gibt TRUE zurück und legt den Status-Member von fest.
MINIDUMP_CALLBACK_OUTPUT an
S_FALSE sendet die Minidump-Bibliothek alle E/A-Vorgänge über Rückrufe. Der Aufrufer wird
einen IoWriteAllCallback-Rückruf für jeden Datenabschnitt erhalten.


DbgHelp 6.4 und früher: Dieser Wert wird nicht unterstützt.
IoWriteAllCallback
Der Rückruf muss alle angeforderten Bytes schreiben oder schlägt fehl. Das Io-Element des
MINIDUMP_CALLBACK_INPUT-Struktur enthält
die Anforderung. Wenn der Schreibvorgang fehlschlägt, sollte der Rückruf FALSE zurückgeben. Wird der
Schreibvorgang erfolgreich, der Rückruf sollte TRUE zurückgeben und festlegen,
Statusmitglied von
MINIDUMP_CALLBACK_OUTPUT an
S_OK. Der Aufrufer erhält einen IoFinishCallback-Rückruf .
, wenn die E/A abgeschlossen ist.


DbgHelp 6.4 und früher: Dieser Wert wird nicht unterstützt.
IoFinishCallback
Der Rückruf gibt E/A-Abschlussinformationen zurück. Wenn der Rückruf FALSE oder zurückgibt
legt den Status-Member von nicht fest.
MINIDUMP_CALLBACK_OUTPUT an
S_OK geht die minidump-Bibliothek davon aus, dass der Minidump-Schreibvorgang fehlgeschlagen ist.


DbgHelp 6.4 und früher: Dieser Wert wird nicht unterstützt.
ReadMemoryFailureCallback
Es ist ein Fehler beim Lesen des Arbeitsspeichers aufgetreten. Wenn der Rückruf TRUE zurückgibt und legt
Das Status-Element von
MINIDUMP_CALLBACK_OUTPUT an
S_OK wird der Speicherfehler ignoriert, und der Block wird im Minidump weggelassen. Andernfalls wird dies
fehler führt zu einem Fehler beim Schreiben in den Minidump.


DbgHelp 6.4 und früher: Dieser Wert wird nicht unterstützt.
SecondaryFlagsCallback
Der Rückruf gibt sekundäre Informationen zurück.


DbgHelp 6.5 und früher: Dieser Wert wird nicht unterstützt.
IsProcessSnapshotCallback
Die Rückruffunktion gibt an, ob das Ziel ein Prozess oder ein Momentaufnahme ist.

DbgHelp 6.2 und früher: Dieser Wert wird nicht unterstützt.
VmStartCallback
Die Rückruffunktion gibt an, ob der Aufgerufene Rückrufe für virtuellen Arbeitsspeicher unterstützt und akzeptiert, z. B. VmQueryCallback, VmPreReadCallback und VmPostReadCallback.

Ein Rückgabewert von S_FALSE bedeutet, dass Rückrufe des virtuellen Speichers unterstützt werden. Der Wert S_OK bedeutet, dass Rückrufe für virtuellen Speicher nicht unterstützt werden.

DbgHelp 6.2 und früher: Dieser Wert wird nicht unterstützt.
VmQueryCallback
Die Rückruffunktion wird für Momentaufnahme Ziele aufgerufen, um Informationen zum virtuellen Adressspeicher vom Ziel zu sammeln.
Der Rückruf wird nur aufgerufen, wenn VmStartCallback den Wert S_FALSE zurückgegeben hat.


DbgHelp 6.2 und früher: Dieser Wert wird nicht unterstützt.
VmPreReadCallback
Die Rückruffunktion wird für jeden ReadVirtual-Vorgang gesendet. Diese Lesevorgänge sind nicht auf die Speicherblöcke beschränkt, die dem Speicherabbild hinzugefügt werden. Die Engine greift auch auf den Prozessumgebungsblock (Process Environment Block, PEB), den Threadumgebungsblock (THREAD Environment Block, TEB), die Ladeprogrammdaten, die entladenen Modulablaufverfolgungen und andere Blöcke zu. Auch wenn diese Blöcke nicht im Speicherabbild landen, werden sie aus dem Ziel gelesen, und für jeden werden Rückrufe für virtuellen Speicher initiiert. Der Rückruf wird nur aufgerufen, wenn VmStartCallback S_FALSE zurückgegeben hat.

DbgHelp 6.2 und früher: Dieser Wert wird nicht unterstützt.
VmPostReadCallback
Die Rückruffunktion ermöglicht es dem Aufgerufenen, den Pufferinhalt mit Daten aus anderen Quellen, z. B. einem Cache, zu ändern oder eine Verschleierung durchzuführen. Der Puffer wird an diesem Punkt vollständig oder teilweise von VmPreReadCallback und ReadProcessMemory gefüllt. Der Rückruf wird nur aufgerufen, wenn VmStartCallback S_FALSE zurückgegeben hat.

DbgHelp 6.2 und früher: Dieser Wert wird nicht unterstützt.

Anforderungen

Anforderung Wert
Header minidumpapiset.h (dbgHelp.h einschließen)
Verteilbare Komponente DbgHelp.dll 5.1 oder höher

Weitere Informationen

MINIDUMP_CALLBACK_INPUT

MiniDumpCallback