перечисление MINIDUMP_CALLBACK_TYPE (minidumpapiset.h)

  • Статья

Определяет тип сведений, возвращаемых функцией MiniDumpCallback . Не все сбои памяти приводят к обратному вызову; Например, если сбой находится в стеке, то сбой считается неустранимым, и минидамп завершится ошибкой.

Синтаксис

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;

Константы

 
ModuleCallback
Функция обратного вызова возвращает сведения о модуле.
ThreadCallback
Функция обратного вызова возвращает сведения о потоке.
ThreadExCallback
Функция обратного вызова возвращает расширенные сведения о потоке.
IncludeThreadCallback
Функция обратного вызова указывает, какие потоки следует включить. Она называется так, как библиотека minidump
перечисление потоков в процессе, а не после собранных сведений, как с
ThreadCallback или ThreadExCallback. Он называется для
каждый поток. Если функция обратного вызова возвращает значение FALSE, текущий поток исключается.
Это позволяет вызывающей объекту получать сведения для подмножества потоков в процессе без приостановки
потоки, которые не представляют интереса. Кроме того, можно изменить ThreadWriteFlags.
член MINIDUMP_CALLBACK_OUTPUT
структурировать и возвращать значение TRUE , чтобы избежать сбора ненужных сведений для
интерфейса.
IncludeModuleCallback
Функция обратного вызова указывает, какие модули следует включить. Функция обратного вызова вызывается как
Библиотека minidump перечисляет модули в процессе, а не после сбора информации.
имеет значение с ModuleCallback. Он вызывается для каждого модуля. Если функция обратного вызова
возвращает значение FALSE, текущий модуль исключен. Кроме того, можно изменить
Элемент ModuleWriteFlags элемента
MINIDUMP_CALLBACK_OUTPUT структура и
возвращает значение TRUE , чтобы избежать сбора ненужных сведений для модуля.
MemoryCallback
Функция обратного вызова возвращает область памяти для включения в дамп. Вызывается только обратный вызов.
для дампов, созданных без флага MiniDumpWithFullMemory. Если функция обратного вызова возвращает
False или область с размером 0, обратный вызов не будет вызываться повторно.


DbgHelp 6.1 и более ранних версий: Это значение не поддерживается.
CancelCallback
Функция обратного вызова возвращает сведения об отмене.


DbgHelp 6.1 и более ранних версий: Это значение не поддерживается.
WriteKernelMinidumpCallback
Минидамп пользовательского режима успешно завершен. Чтобы инициировать минидамп в режиме ядра, выполните обратный вызов.
должен вернуть значение TRUE и задать элемент Handle объекта
MINIDUMP_CALLBACK_OUTPUT структура.


DbgHelp 6.1 и более ранних версий: Это значение не поддерживается.
KernelMinidumpStatusCallback
Функция обратного вызова возвращает сведения о состоянии для минидампа ядра.


DbgHelp 6.1 и более ранних версий: Это значение не поддерживается.
RemoveMemoryCallback
Функция обратного вызова возвращает область памяти, которую необходимо исключить из дампа. Вызывается только обратный вызов.
для дампов, созданных без флага MiniDumpWithFullMemory . Если обратный вызов
функция возвращает значение FALSE или область с размером 0, обратный вызов не будет вызываться повторно.


DbgHelp 6.3 и более ранних версий: Это значение не поддерживается.
IncludeVmRegionCallback
Функция обратного вызова возвращает сведения о области виртуальной памяти. Он вызывается дважды для каждого
регион во время прохода записи в полной памяти. Член VmRegion объекта
структура MINIDUMP_CALLBACK_OUTPUT
содержит текущую область памяти. Вы можете изменить базовый адрес и размер региона при условии, что новый
регион остается подмножеством исходного региона; Изменения в других элементах игнорируются. Если обратный вызов возвращает
ЗНАЧЕНИЕ TRUE и задает элемент Continue для
MINIDUMP_CALLBACK_OUTPUT в
True, библиотека minidump будет использовать регион, указанный параметром
VmRegion в качестве региона для записи. Если обратный вызов возвращает
FALSE или значение , если значение Continue имеет значение FALSE,
обратный вызов не будет вызываться для дополнительных областей памяти.


DbgHelp 6.4 и более ранних версий: Это значение не поддерживается.
IoStartCallback
Функция обратного вызова указывает, что вызывающий объект будет предоставлять альтернативную подпрограмму ввода-вывода. Если обратный вызов
возвращает значение TRUE и задает элемент Status для
MINIDUMP_CALLBACK_OUTPUT в
S_FALSE библиотека минидампов будет отправлять все ввод-вывод через обратные вызовы. Вызывающий объект будет
получает обратный вызов IoWriteAllCallback для каждого фрагмента данных.


DbgHelp 6.4 и более ранних версий: Это значение не поддерживается.
IoWriteAllCallback
Обратный вызов должен записать все запрошенные байты или завершиться ошибкой. Элемент Io объекта
MINIDUMP_CALLBACK_INPUT структура содержит
запрос. Если операция записи завершается сбоем, обратный вызов должен возвращать значение FALSE. Если
Операция записи завершается успешно, обратный вызов должен вернуть значение TRUE и задать
Участник состояния
MINIDUMP_CALLBACK_OUTPUT в
S_OK. Вызывающий объект получит обратный вызов IoFinishCallback .
после завершения ввода-вывода.


DbgHelp 6.4 и более ранних версий: Это значение не поддерживается.
IoFinishCallback
Обратный вызов возвращает сведения о завершении ввода-вывода. Если обратный вызов возвращает значение FALSE , или
не задает элемент Status для
MINIDUMP_CALLBACK_OUTPUT в
S_OK библиотека minidump предполагает, что операция записи minidump завершилась сбоем.


DbgHelp 6.4 и более ранних версий: Это значение не поддерживается.
ReadMemoryFailureCallback
Произошел сбой чтения памяти. Если обратный вызов возвращает значение TRUE и задает
Элемент Status
MINIDUMP_CALLBACK_OUTPUT в
S_OK, сбой памяти игнорируется, а блок опущен в минидампе. В противном случае это
сбой приводит к сбою записи в минидамп.


DbgHelp 6.4 и более ранних версий: Это значение не поддерживается.
SecondaryFlagsCallback
Обратный вызов возвращает дополнительные сведения.


DbgHelp 6.5 и более ранних версий: Это значение не поддерживается.
IsProcessSnapshotCallback
Функция обратного вызова указывает, является ли целевой процесс или snapshot.

DbgHelp 6.2 и более ранних версий: Это значение не поддерживается.
VmStartCallback
Функция обратного вызова указывает, поддерживает ли вызываемый объект и принимает ли он обратные вызовы виртуальной памяти, такие как VmQueryCallback, VmPreReadCallback и VmPostReadCallback.

Возвращаемое значение S_FALSE означает, что поддерживаются обратные вызовы виртуальной памяти. Значение S_OK означает, что обратные вызовы виртуальной памяти не поддерживаются.

DbgHelp 6.2 и более ранних версий: Это значение не поддерживается.
VmQueryCallback
Функция обратного вызова вызывается для snapshot целевых объектов для сбора сведений о памяти виртуального адреса из целевого объекта.
Обратный вызов вызывается только в том случае , если VmStartCallback вернул значение S_FALSE.


DbgHelp 6.2 и более ранних версий: Это значение не поддерживается.
VmPreReadCallback
Функция обратного вызова отправляется для каждой операции ReadVirtual. Эти операции чтения не ограничиваются блоками памяти, которые добавляются в дамп. Подсистема также обращается к блоку среды процесса (PEB), блоку среды потока (TEB), данным загрузчика, трассировкам выгруженного модуля и другим блокам. Даже если эти блоки не помещаются в дамп, они считываются из целевого объекта, и для каждого из них инициируются обратные вызовы виртуальной памяти. Обратный вызов вызывается только в том случае , если VmStartCallback вернул S_FALSE.

DbgHelp 6.2 и более ранних версий: Это значение не поддерживается.
VmPostReadCallback
Функция обратного вызова позволяет вызываемой объекту изменять содержимое буфера с данными из других источников, таких как кэш, или выполнять маскировку. На этом этапе буфер полностью или частично заполняется vmPreReadCallback и ReadProcessMemory. Обратный вызов вызывается только в том случае , если VmStartCallback вернул S_FALSE.

DbgHelp 6.2 и более ранних версий: Это значение не поддерживается.

Требования

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

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

MINIDUMP_CALLBACK_INPUT

MiniDumpCallback