KBUGCHECK_SECONDARY_DUMP_DATA_EX結構 (wdm.h)

發行項
02/29/2024

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旗標，但不能同時設定兩者。在回呼例程的專案上，旗標會初始化為零。

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

包含錯誤檢查程式代碼，指定錯誤檢查的原因。回呼例程可以使用這項資訊來決定是否要將任何頁面新增至損毀傾印檔案。如需錯誤檢查碼的完整清單，請參閱 WDK 中包含的 Bugcodes.h 頭檔。

BugCheckParameter1

錯誤檢查參數 1。錯誤檢查參數會通知回呼已傳遞至 KeBugcheckEx 的錯誤檢查參數。

BugCheckParameter2

錯誤檢查參數 2。錯誤檢查參數會通知回呼已傳遞至 KeBugcheckEx 的錯誤檢查參數。

BugCheckParameter3

錯誤檢查參數 3。錯誤檢查參數會通知回呼已傳遞至 KeBugcheckEx 的錯誤檢查參數。

BugCheckParameter4

錯誤檢查參數 4。錯誤檢查參數會通知回呼已傳遞至 KeBugcheckEx 的錯誤檢查參數。

備註

如需錯誤檢查回呼例程的詳細資訊，請參閱撰寫錯誤檢查回呼例程。

規格需求

需求	值
標頭	wdm.h

另請參閱

撰寫錯誤檢查回呼例程。 KBUGCHECK_REASON_CALLBACK_ROUTINE

共用方式為