KBUGCHECK_SECONDARY_DUMP_DATA_EX结构(wdm.h)

KBUGCHECK_SECONDARY_DUMP_DATA_EX 结构描述由 KBUGCHECK_REASON_CALLBACK_ROUTINE 回调例程写入故障转储文件的多部分数据。

语法

typedef struct _KBUGCHECK_SECONDARY_DUMP_DATA_EX {
  PVOID     InBuffer;
  ULONG     InBufferLength;
  ULONG     MaximumAllowed;
  GUID      Guid;
  PVOID     OutBuffer;
  ULONG     OutBufferLength;
  PVOID     Context;
  ULONG     Flags;
  ULONG     DumpType;
  ULONG     BugCheckCode;
  ULONG_PTR BugCheckParameter1;
  ULONG_PTR BugCheckParameter2;
  ULONG_PTR BugCheckParameter3;
  ULONG_PTR BugCheckParameter4;
} KBUGCHECK_SECONDARY_DUMP_DATA_EX, *PKBUGCHECK_SECONDARY_DUMP_DATA_EX;

成员

InBuffer

指向系统分配的缓冲区的指针。

InBufferLength

指定由 InBuffer 成员指定的缓冲区大小(以字节为单位)。

MaximumAllowed

指定 KBUGCHECK_REASON_CALLBACK_ROUTINE 例程可以写入故障转储文件的最大数据量。

Guid

指定标识驱动程序故障转储数据的 GUID。 (驱动程序必须使用唯一 GUID 来标记其故障转储数据。 使用 GuidGen.exe 工具为驱动程序生成 GUID。

OutBuffer

指向驱动程序写入故障转储数据的缓冲区的指针,或 NULL

OutBufferLength

指定由 OutBuffer 成员指定的缓冲区的大小(以字节为单位)。

Context

包含专用上下文数据,以便独占使用回调例程。 回调例程可以将此成员设置为任何值。 通常,如果需要多次调用回调例程,则例程会将此成员设置为在初始调用期间指向驱动程序提供的缓冲区。 在后续调用期间,回调例程可以读取此缓冲区的先前内容并更新其内容。 在对回调例程的初始调用之前,上下文为 NULL。

Flags

包含描述加载项页面请求的标志。 回调例程必须设置此成员的值。 将此成员设置为以下一个或多个标志位的按位 OR:

KB_ADD_PAGES_FLAG_VIRTUAL_ADDRESS

指示 地址 成员包含虚拟地址。

KB_ADD_PAGES_FLAG_PHYSICAL_ADDRESS

指示 地址 成员包含物理地址。

KB_ADD_PAGES_FLAG_ADDITIONAL_RANGES_EXIST

指示回调例程请求再次调用它,以便它可以添加更多页面。

回调例程必须设置KB_ADD_PAGES_FLAG_VIRTUAL_ADDRESS标志或KB_ADD_PAGES_FLAG_PHYSICAL_ADDRESS标志,但不能同时设置两者。 在回调例程的条目上,标志 初始化为零。

DumpType

以下转储类型之一。

    DUMP_TYPE_INVALID           = -1,
    DUMP_TYPE_UNKNOWN           = 0,
    DUMP_TYPE_FULL              = 1,
    DUMP_TYPE_SUMMARY           = 2,
    DUMP_TYPE_HEADER            = 3,
    DUMP_TYPE_TRIAGE            = 4,
    DUMP_TYPE_BITMAP_FULL       = 5,
    DUMP_TYPE_BITMAP_KERNEL     = 6,
    DUMP_TYPE_AUTOMATIC         = 7

BugCheckCode

包含 bug 检查代码,该代码指定 bug 检查的原因。 回调例程可以使用此信息决定是否将任何页面添加到故障转储文件中。 有关 bug 检查代码的完整列表,请参阅 WDK 中包含的 Bugcodes.h 头文件。

BugCheckParameter1

Bug 检查参数 1。 bug 检查参数通知回调传递给 KeBugcheckEx 的 bug 检查参数。

BugCheckParameter2

Bug 检查参数 2。 bug 检查参数通知回调传递给 KeBugcheckEx 的 bug 检查参数。

BugCheckParameter3

Bug 检查参数 3。 bug 检查参数通知回调传递给 KeBugcheckEx 的 bug 检查参数。

BugCheckParameter4

Bug 检查参数 4。 bug 检查参数通知回调传递给 KeBugcheckEx 的 bug 检查参数。

言论

有关 bug 检查回调例程的详细信息,请参阅 编写 bug 检查回调例程

要求

要求 价值
标头 wdm.h

另请参阅

编写 bug 检查回调例程 KBUGCHECK_REASON_CALLBACK_ROUTINE