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回调函数指示要包含的线程。 它被称为小型转储库 枚举进程中的线程，而不是在收集的信息之后，就像它一样 ThreadCallback 或 ThreadExCallback。 它被调用 每个线程。 如果回调函数返回 FALSE，则排除当前线程。 这允许调用方获取进程中线程子集的信息，而无需挂起 不感兴趣的线程。 或者，可以修改 ThreadWriteFlags MINIDUMP_CALLBACK_OUTPUT的成员 结构并返回 TRUE ，以避免收集不必要的信息 运行。 |
IncludeModuleCallback回调函数指示要包含的模块。 回调函数作为 小型转储库枚举进程中的模块，而不是在收集信息后，因为它 使用 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，小型转储库将使用 指定的区域 VmRegion 作为要写入的区域。 如果回调返回 FALSE 或如果 Continue 为 FALSE， 不会为其他内存区域调用回调。 DbgHelp 6.4 及更早版本： 不支持此值。 |
IoStartCallback回调函数指示调用方将提供备用 I/O 例程。 如果回调 返回 TRUE ，并将 Status 成员设置为 MINIDUMP_CALLBACK_OUTPUT S_FALSE，小型转储库将通过回调发送所有 I/O。 调用方将 接收每个数据片段的 IoWriteAllCallback 回调。 DbgHelp 6.4 及更早版本： 不支持此值。 |
IoWriteAllCallback回调必须写入所有请求的字节或失败。 的 Io 成员 MINIDUMP_CALLBACK_INPUT 结构包含 请求。 如果写入操作失败，回调应返回 FALSE。 如果你的设备不支持 写入操作成功，回调应返回 TRUE 并设置 的状态 成员 MINIDUMP_CALLBACK_OUTPUT S_OK。 调用方将收到 IoFinishCallback 回调 I/O 完成时。 DbgHelp 6.4 及更早版本： 不支持此值。 |
IoFinishCallback回调返回 I/O 完成信息。 如果回调返回 FALSE 或 不设置 的 Status 成员 MINIDUMP_CALLBACK_OUTPUT S_OK，小型转储库假定小型转储写入操作失败。 DbgHelp 6.4 及更早版本： 不支持此值。 |
ReadMemoryFailureCallback读取内存失败。 如果回调返回 TRUE 并设置 的 Status 成员 MINIDUMP_CALLBACK_OUTPUT S_OK，将忽略内存故障，并从小型转储中省略该块。 否则，则为 失败会导致无法写入到小型转储。 DbgHelp 6.4 及更早版本： 不支持此值。 |
SecondaryFlagsCallback回调返回辅助信息。 DbgHelp 6.5 及更早版本： 不支持此值。 |
IsProcessSnapshotCallback回调函数指示目标是进程还是快照。 DbgHelp 6.2 及更早版本： 不支持此值。 |
VmStartCallback回调函数指示被调用方是否支持和接受虚拟内存回调，例如 VmQueryCallback、 VmPreReadCallback 和 VmPostReadCallback。 返回值S_FALSE表示支持虚拟内存回调。 值S_OK表示不支持虚拟内存回调。 DbgHelp 6.2 及更早版本： 不支持此值。 |
VmQueryCallback为快照目标调用回调函数，以从目标收集虚拟地址内存信息。 仅当 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 及更早版本： 不支持此值。 |
要求
| 要求 | 值 |
|---|---|
| Header | minidumpapiset.h (包括 DbgHelp.h) |
| 可再发行组件 | DbgHelp.dll 5.1 或更高版本 |