KBUGCHECK_REASON_CALLBACK_ROUTINE fungsi panggilan balik (wdm.h)

  • Artikel

Fungsi panggilan balik yang diimplementasikan driver yang dijalankan sistem ketika mengeluarkan pemeriksaan bug.

Lihat KBUGCHECK_CALLBACK_REASON untuk informasi tentang jenis panggilan balik yang tersedia.

Sintaks

KBUGCHECK_REASON_CALLBACK_ROUTINE KbugcheckReasonCallbackRoutine;

void KbugcheckReasonCallbackRoutine(
  [in]      KBUGCHECK_CALLBACK_REASON Reason,
  [in]      _KBUGCHECK_REASON_CALLBACK_RECORD *Record,
  [in, out] PVOID ReasonSpecificData,
  [in]      ULONG ReasonSpecificDataLength
)
{...}

Parameter

[in] Reason

Enumerasi jenis KBUGCHECK_CALLBACK_REASON yang menentukan alasan panggilan ke rutinitas panggilan balik.

[in] Record

Penunjuk ke struktur KBUGCHECK_REASON_CALLBACK_RECORD yang disediakan driver ketika mendaftarkan panggilan balik ini. Untuk informasi selengkapnya, lihat deskripsi parameter CallbackRecord di KeRegisterBugCheckReasonCallback.

[in, out] ReasonSpecificData

Penunjuk ke buffer yang berisi struktur jenis yang ditentukan oleh tabel di bawah ini. Anggota tertentu dari struktur ini diisi oleh sistem operasi sebelum memanggil rutinitas panggilan balik, dan anggota lain harus diisi oleh rutinitas panggilan balik. Untuk informasi selengkapnya, lihat Menulis Rutinitas Panggilan Balik Pemeriksaan Bug.

Nilai Struktur data
KbCallbackSecondaryDumpData KBUGCHECK_SECONDARY_DUMP_DATA
KbCallbackDumpIo KBUGCHECK_DUMP_IO
KbCallbackAddPages KBUGCHECK_ADD_PAGES
KbCallbackSecondaryMultiPartDumpData KBUGCHECK_SECONDARY_DUMP_DATA_EX
KbCallbackRemovePages KBUGCHECK_REMOVE_PAGES
KbCallbackTriageDumpData KBUGCHECK_TRIAGE_DUMP_DATA

[in] ReasonSpecificDataLength

Menentukan ukuran, dalam byte, dari buffer yang dituju parameter ReasonSpecificData .

Nilai kembali

Tidak ada

Keterangan

Untuk informasi tentang cara menerapkan rutinitas panggilan balik ini, lihat Menulis Rutinitas Panggilan Balik Pemeriksaan Bug.

Untuk kode sampel yang menunjukkan cara menulis data ke file crash dump, lihat DMF_CrashDump.

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
IRQL Dipanggil di HIGH_LEVEL.

Lihat juga

KBUGCHECK_ADD_PAGES

KBUGCHECK_CALLBACK_REASON

KBUGCHECK_REASON_CALLBACK_RECORD

KeRegisterBugCheckReasonCallback

KeDeregisterBugCheckReasonCallback

Menulis Bug Check Callback Routine.