структура 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 или более поздней версии |