struktur KBUGCHECK_SECONDARY_DUMP_DATA_EX (wdm.h)

Struktur KBUGCHECK_SECONDARY_DUMP_DATA_EX menjelaskan data multibagian yang akan ditulis oleh KBUGCHECK_REASON_CALLBACK_ROUTINE rutin panggilan balik ke file crash dump.

Sintaks

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;

Anggota

InBuffer

Penunjuk ke buffer yang dialokasikan oleh sistem.

InBufferLength

Menentukan ukuran buffer, dalam byte, yang ditentukan oleh anggota InBuffer .

MaximumAllowed

Menentukan jumlah maksimum data yang dapat ditulis KBUGCHECK_REASON_CALLBACK_ROUTINE rutin ke file crash dump.

Guid

Menentukan GUID yang mengidentifikasi data crash dump driver. (Driver harus menggunakan GUID unik untuk menandai data crash dump mereka. Gunakan alat GuidGen.exe untuk menghasilkan GUID untuk driver Anda.

OutBuffer

Arahkan ke buffer tempat driver menulis data crash dump-nya, atau NULL.

OutBufferLength

Menentukan ukuran buffer, dalam byte, yang ditentukan oleh anggota OutBuffer .

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, rutinitas mengatur anggota ini untuk menunjuk ke buffer yang disediakan driver selama panggilan awal. Selama panggilan berikutnya, rutinitas panggilan balik dapat membaca konten sebelumnya dari buffer ini 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.

DumpType

Salah satu jenis cadangan berikut.

    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

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.

BugCheckParameter1

Parameter Pemeriksaan Bug 1. Parameter pemeriksaan bug menginformasikan panggilan balik parameter bugcheck yang diteruskan ke KeBugcheckEx.

BugCheckParameter2

Parameter Pemeriksaan Bug 2. Parameter pemeriksaan bug menginformasikan panggilan balik parameter bugcheck yang diteruskan ke KeBugcheckEx.

BugCheckParameter3

Parameter Pemeriksaan Bug 3. Parameter pemeriksaan bug menginformasikan panggilan balik parameter bugcheck yang diteruskan ke KeBugcheckEx.

BugCheckParameter4

Parameter Pemeriksaan Bug 4. Parameter pemeriksaan bug menginformasikan panggilan balik parameter bugcheck yang diteruskan ke KeBugcheckEx.

Keterangan

Untuk informasi selengkapnya tentang rutinitas panggilan balik pemeriksaan bug, lihat Menulis Rutinitas Panggilan Balik Pemeriksaan Bug.

Persyaratan

Persyaratan	Nilai
Header	wdm.h

Lihat juga

Menulis Bug Check Callback Routine. KBUGCHECK_REASON_CALLBACK_ROUTINE