KBUGCHECK_SECONDARY_DUMP_DATA_EX 構造体 (wdm.h)

[アーティクル]
02/27/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

ページの追加要求を記述するフラグが含まれます。コールバックルーチンは、このメンバーの値を設定する必要があります。このメンバーを、次のフラグビットの 1 つ以上のビットごとの 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 フラグを設定する必要がありますが、両方を設定する必要はありません。コールバックルーチンへのエントリでは、 フラグ は 0 に初期化されます。

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 に渡されたバグチェックパラメーターをコールバックに通知します。

注釈

バグチェックコールバックルーチンの詳細については、「バグチェックコールバックルーチンの記述」を参照してください。

要件

要件	値
Header	wdm.h

こちらもご覧ください

バグチェックコールバックルーチンの記述。 KBUGCHECK_REASON_CALLBACK_ROUTINE

次の方法で共有