MINIDUMP_CALLBACK_OUTPUT-Struktur (minidumpapiset.h)

Enthält Informationen, die von der MiniDumpCallback-Funktion zurückgegeben werden.

Syntax

typedef struct _MINIDUMP_CALLBACK_OUTPUT {
  union {
    ULONG   ModuleWriteFlags;
    ULONG   ThreadWriteFlags;
    ULONG   SecondaryFlags;
    struct {
      ULONG64 MemoryBase;
      ULONG   MemorySize;
    };
    struct {
      BOOL CheckCancel;
      BOOL Cancel;
    };
    HANDLE  Handle;
    struct {
      MINIDUMP_MEMORY_INFO VmRegion;
      BOOL                 Continue;
    };
    struct {
      HRESULT              VmQueryStatus;
      MINIDUMP_MEMORY_INFO VmQueryResult;
    };
    struct {
      HRESULT VmReadStatus;
      ULONG   VmReadBytesCompleted;
    };
    HRESULT Status;
  };
} MINIDUMP_CALLBACK_OUTPUT, *PMINIDUMP_CALLBACK_OUTPUT;

Member

ModuleWriteFlags

Die Modulschreibvorgangsflags. Bei diesem Member kann es sich um einen oder mehrere Werte in der MODULE_WRITE_FLAGS-Enumeration handeln. Die Flags werden bei der Eingabe des Rückrufs auf ihre Standardwerte festgelegt.

Dieses Element wird ignoriert, es sei denn, der Rückruftyp ist IncludeModuleCallback oder ModuleCallback.

ThreadWriteFlags

Die Threadschreibvorgangsflags. Bei diesem Member kann es sich um einen oder mehrere Werte in der THREAD_WRITE_FLAGS-Enumeration handeln. Die Flags werden bei der Eingabe des Rückrufs auf ihre Standardwerte festgelegt.

Dieses Element wird ignoriert, es sei denn, der Rückruftyp ist IncludeThreadCallback, ThreadCallback oder ThreadExCallback.

SecondaryFlags

Enthält einen Wert aus dem MINIDUMP_SECONDARY_FLAGS Enumerationstyp.

DbgHelp 6.5 und früher: Dieser Member ist nicht verfügbar.

MemoryBase

Die Basisadresse des Speicherbereichs, der in das Dump eingeschlossen werden soll.

Dieses Element wird ignoriert, es sei denn, der Rückruftyp ist MemoryCallback oder RemoveMemoryCallback.

MemorySize

Die Größe des Speicherbereichs, der in das Dump eingeschlossen werden soll, in Bytes.

Dieses Element wird ignoriert, es sei denn, der Rückruftyp ist MemoryCallback oder RemoveMemoryCallback.

CheckCancel

Steuert, ob die Rückruffunktion Abbruchrückrufe empfangen soll. Wenn dieses Element TRUE ist, werden die Rückrufe zum Abbrechen fortgesetzt. Andernfalls nicht.

Dieser Member wird ignoriert, es sei denn, der Rückruftyp ist CancelCallback.

Cancel

Steuert, ob das Dump abgebrochen werden soll. Wenn die Rückruffunktion TRUE zurückgibt und Canceltrue ist, wird das Dump abgebrochen. In diesem Fall schlägt die MiniDumpWriteDump-Funktion fehl, und das Dump ist ungültig.

Dieser Member wird ignoriert, es sei denn, der Rückruftyp ist CancelCallback.

Handle

Ein Handle für die Datei, in die ein Kernel-Minidump geschrieben wird.

Dieses Element wird ignoriert, es sei denn, der Rückruftyp ist WriteKernelMinidumpCallback.

VmRegion

Eine MINIDUMP_MEMORY_INFO Struktur, die die Region des virtuellen Arbeitsspeichers beschreibt. Die Regionsbasis und -größe müssen an einer Seitengrenze ausgerichtet werden. Die Regionsgröße kann auf 0 festgelegt werden, um die Region herauszufiltern.

Dieser Member wird ignoriert, es sei denn, der Rückruftyp ist IncludeVmRegionCallback.

Continue

Steuert, ob das Dump fortgesetzt werden soll. Wenn die Rückruffunktion TRUE zurückgibt und Continuetrue ist, wird das Dump fortgesetzt. Andernfalls schlägt die MiniDumpWriteDump-Funktion fehl, und das Dump ist ungültig.

Dieser Member wird ignoriert, es sei denn, der Rückruftyp ist IncludeVmRegionCallback.

VmQueryStatus

VmQueryResult

VmReadStatus

VmReadBytesCompleted

Status

Der Status des Vorgangs.

Dieses Element wird ignoriert, es sei denn, der Rückruftyp lautet ReadMemoryFailureCallback, IoStartCallback, IoWriteAllCallback oder IoFinishCallback.

Anforderungen

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

Weitere Informationen

MODULE_WRITE_FLAGS

MiniDumpCallback

THREAD_WRITE_FLAGS