структура MINIDUMP_CALLBACK_OUTPUT (minidumpapiset.h)

  • Статья

Содержит сведения, возвращаемые функцией MiniDumpCallback .

Синтаксис

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;

Члены

ModuleWriteFlags

Флаги операции записи модуля. Этот элемент может быть одним или несколькими значениями в перечислении MODULE_WRITE_FLAGS . Флагам присваиваются значения по умолчанию при входе в обратный вызов.

Этот элемент игнорируется, если только тип обратного вызова не является IncludeModuleCallback или ModuleCallback.

ThreadWriteFlags

Флаги операции записи потока. Этот элемент может быть одним или несколькими значениями в перечислении THREAD_WRITE_FLAGS . Флагам присваиваются значения по умолчанию при входе в обратный вызов.

Этот член игнорируется, если только тип обратного вызова не имеет значения IncludeThreadCallback, ThreadCallback или ThreadExCallback.

SecondaryFlags

Содержит значение из типа перечисления MINIDUMP_SECONDARY_FLAGS .

DbgHelp 6.5 и более ранних версий: Этот элемент недоступен.

MemoryBase

Базовый адрес области памяти, включенной в дамп.

Этот элемент игнорируется, если тип обратного вызова не является MemoryCallback или RemoveMemoryCallback.

MemorySize

Размер области памяти, включаемой в дамп, в байтах.

Этот элемент игнорируется, если тип обратного вызова не является MemoryCallback или RemoveMemoryCallback.

CheckCancel

Определяет, должна ли функция обратного вызова получать обратные вызовы отмены. Если этот член имеет значение TRUE, обратные вызовы отмены будут продолжены. В противном случае они не будут.

Этот элемент игнорируется, если только тип обратного вызова не является CancelCallback.

Cancel

Определяет, следует ли отменить дамп. Если функция обратного вызова возвращает значение TRUE , а Отмена имеет значение TRUE, дамп будет отменен. В этом случае происходит сбой функции MiniDumpWriteDump и недопустимый дамп.

Этот элемент игнорируется, если только тип обратного вызова не является CancelCallback.

Handle

Дескриптор файла, в который будет записан минидамп ядра.

Этот член игнорируется, если только тип обратного вызова не является WriteKernelMinidumpCallback.

VmRegion

Структура MINIDUMP_MEMORY_INFO, описывающая область виртуальной памяти. База и размер региона должны быть выровнены по границе страницы. Размер региона можно задать равным 0, чтобы отфильтровать регион.

Этот элемент игнорируется, если только тип обратного вызова не является IncludeVmRegionCallback.

Continue

Определяет, следует ли продолжить дамп. Если функция обратного вызова возвращает значение TRUE , а значение Continue имеет значение TRUE, дамп будет продолжен. В противном случае функция MiniDumpWriteDump завершается сбоем и дамп недопустим.

Этот элемент игнорируется, если только тип обратного вызова не является IncludeVmRegionCallback.

VmQueryStatus

VmQueryResult

VmReadStatus

VmReadBytesCompleted

Status

Состояние операции.

Этот член игнорируется, если только тип обратного вызова не имеет значения ReadMemoryFailureCallback, IoStartCallback, IoWriteAllCallback или IoFinishCallback.

Требования

Требование Значение
Заголовок minidumpapiset.h (включая DbgHelp.h)
Распространяемые компоненты DbgHelp.dll 5.1 или более поздней версии

См. также раздел

MODULE_WRITE_FLAGS

MiniDumpCallback

THREAD_WRITE_FLAGS