通过

wdm.h) (KBUGCHECK_SECONDARY_DUMP_DATA_EX 结构

  • 项目

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

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

Flags

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

KB_ADD_PAGES_FLAG_VIRTUAL_ADDRESS

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

KB_ADD_PAGES_FLAG_PHYSICAL_ADDRESS

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

KB_ADD_PAGES_FLAG_ADDITIONAL_RANGES_EXIST

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

回调例程必须设置KB_ADD_PAGES_FLAG_VIRTUAL_ADDRESS标志或KB_ADD_PAGES_FLAG_PHYSICAL_ADDRESS标志，但不能同时设置两者。 进入回调例程时， Flags 初始化为零。

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 检查回调例程。

要求

要求 值
Header wdm.h

另请参阅

编写 Bug 检查回调例程。 KBUGCHECK_REASON_CALLBACK_ROUTINE