struktur KBUGCHECK_ADD_PAGES (wdm.h)

  • Artikel

Struktur KBUGCHECK_ADD_PAGES menjelaskan satu atau beberapa halaman data yang disediakan driver untuk ditulis oleh fungsi panggilan balik KBUGCHECK_REASON_CALLBACK_ROUTINE ke file crash dump.

Sintaks

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

Anggota

Context

Berisi data konteks privat untuk penggunaan rutinitas panggilan balik secara eksklusif. Rutinitas panggilan balik dapat mengatur anggota ini ke nilai apa pun. Biasanya, jika rutinitas panggilan balik perlu dipanggil lebih dari satu kali, rutin mengatur anggota ini untuk menunjuk ke buffer yang disediakan driver selama panggilan awal. Selama panggilan berikutnya, rutinitas panggilan balik dapat membaca konten buffer ini sebelumnya dan memperbarui kontennya. Sebelum panggilan awal ke rutinitas panggilan balik, Konteks adalah NULL.

Flags

Berisi bendera yang menjelaskan permintaan add-page. Rutinitas panggilan balik harus menetapkan nilai anggota ini. Atur anggota ini ke bitwise ATAU dari satu atau beberapa bit bendera berikut:

KB_ADD_PAGES_FLAG_VIRTUAL_ADDRESS

Menunjukkan bahwa anggota Alamat berisi alamat virtual.

KB_ADD_PAGES_FLAG_PHYSICAL_ADDRESS

Menunjukkan bahwa anggota Alamat berisi alamat fisik.

KB_ADD_PAGES_FLAG_ADDITIONAL_RANGES_EXIST

Menunjukkan bahwa panggilan balik rutin memintanya dipanggil lagi sehingga dapat menambahkan lebih banyak halaman.

Rutinitas panggilan balik harus mengatur bendera KB_ADD_PAGES_FLAG_VIRTUAL_ADDRESS atau bendera KB_ADD_PAGES_FLAG_PHYSICAL_ADDRESS, tetapi tidak keduanya. Pada entri ke rutinitas panggilan balik, Bendera diinisialisasi ke nol.

BugCheckCode

Berisi kode pemeriksaan bug, yang menentukan alasan pemeriksaan bug. Rutinitas panggilan balik dapat menggunakan informasi ini untuk memutuskan apakah akan menambahkan halaman apa pun ke file crash dump. Untuk daftar lengkap kode pemeriksaan bug, lihat file header Bugcodes.h yang disertakan dalam WDK.

Address

Menentukan alamat fisik atau virtual halaman atau halaman yang permintaan rutin panggilan baliknya ditambahkan ke file crash dump.

Count

Menentukan jumlah halaman yang berdampingan untuk ditambahkan ke file crash dump, mulai dari alamat virtual atau fisik yang ditentukan oleh anggota Alamat . Jika Count> 1 dan Address adalah alamat virtual, halaman berdekatan di ruang memori virtual. Jika Hitung> 1 dan Alamat adalah alamat fisik, halaman berdekatan di ruang memori fisik. Rutinitas panggilan balik dapat mengatur anggota ini ke nol untuk menunjukkan bahwa tidak perlu menambahkan halaman apa pun ke file crash dump.

Keterangan

Dalam panggilan ke rutinitas panggilan balik KbCallbackAddPages , sistem operasi mengatur parameter Alasan ke KbCallbackAddPages, dan mengatur parameter ReasonSpecificData untuk menunjuk ke struktur KBUGCHECK_ADD_PAGES .

Untuk informasi selengkapnya tentang bagaimana struktur ini digunakan, lihat Menulis Rutinitas Panggilan Balik Pemeriksaan Bug dan fungsi panggilan balik KBUGCHECK_REASON_CALLBACK_ROUTINE .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Didukung di Windows Server 2008 dan versi Windows yang lebih baru.
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)

Lihat juga

Menulis Bug Check Callback Routine.