KBUGCHECK_ADD_PAGES 構造体 (wdm.h)

[アーティクル]
02/27/2024

KBUGCHECK_ADD_PAGES構造体は、KBUGCHECK_REASON_CALLBACK_ROUTINEコールバック関数によってクラッシュダンプファイルに書き込まれるドライバーが提供するデータの 1 つ以上のページを記述します。

構文

typedef struct _KBUGCHECK_ADD_PAGES {
  PVOID     Context;
  ULONG     Flags;
  ULONG     BugCheckCode;
  ULONG_PTR Address;
  ULONG_PTR Count;
} KBUGCHECK_ADD_PAGES, *PKBUGCHECK_ADD_PAGES;

メンバー

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 フラグを設定する必要がありますが、両方を設定する必要はありません。コールバックルーチンへのエントリでは、 Flags は 0 に初期化されます。

BugCheckCode

バグチェックの理由を指定するバグチェックコードが含まれています。コールバックルーチンは、この情報を使用して、クラッシュダンプファイルにページを追加するかどうかを決定できます。バグチェックコードの完全な一覧については、WDK に含まれている Bugcodes.h ヘッダーファイルを参照してください。

Address

コールバックルーチンがクラッシュダンプファイルに追加するように要求するページまたはページの物理アドレスまたは仮想アドレスを指定します。

Count

Address メンバーによって指定された仮想アドレスまたは物理アドレスから開始して、クラッシュダンプファイルに追加する連続するページの数を指定 します 。 Count> 1 と Address が仮想アドレスの場合、ページは仮想メモリ空間内で連続しています。 Count> 1 と Address が物理アドレスの場合、ページは物理メモリ空間内で連続しています。コールバックルーチンは、クラッシュダンプファイルにページを追加する必要がないことを示すために、このメンバーを 0 に設定できます。

注釈

KbCallbackAddPages コールバックルーチンの呼び出しでは、オペレーティングシステムによって Reason パラメーターが KbCallbackAddPages に設定され、ReasonSpecificData パラメーターがKBUGCHECK_ADD_PAGES構造体を指すように設定されます。

この構造体の使用方法の詳細については、「バグチェックコールバックルーチンの記述」および「コールバック関数KBUGCHECK_REASON_CALLBACK_ROUTINE する」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Server 2008 以降のバージョンの Windows でサポートされています。
Header	wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)

こちらもご覧ください

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

次の方法で共有