Fungsi KeRegisterBugCheckReasonCallback (wdm.h)

Artikel
03/08/2023

Fungsi KeRegisterBugCheckReasonCallback mendaftarkan rutinitas panggilan balik yang dijalankan ketika sistem operasi mengeluarkan pemeriksaan bug.

Sintaks

BOOLEAN KeRegisterBugCheckReasonCallback(
  [out] PKBUGCHECK_REASON_CALLBACK_RECORD  CallbackRecord,
  [in]  PKBUGCHECK_REASON_CALLBACK_ROUTINE CallbackRoutine,
  [in]  KBUGCHECK_CALLBACK_REASON          Reason,
  [in]  PUCHAR                             Component
);

Parameter

[out] CallbackRecord

Penunjuk ke struktur KBUGCHECK_REASON_CALLBACK_RECORD yang diinisialisasi oleh panggilan ke rutinitas KeInitializeCallbackRecord yang dijelaskan dalam makro kernel Windows.

[in] CallbackRoutine

Penunjuk ke rutinitas panggilan balik jenis KBUGCHECK_REASON_CALLBACK_ROUTINE untuk mendaftar. Untuk informasi tentang cara menerapkan rutinitas panggilan balik ini, lihat Menulis Rutinitas Panggilan Balik Pemeriksaan Bug.

[in] Reason

Enumerasi jenis KBUGCHECK_CALLBACK_REASON yang menentukan jenis rutinitas panggilan balik yang dituju oleh CallbackRoutine .

[in] Component

Penunjuk ke string ANSI yang dihentikan null yang mengidentifikasi pemanggil. Misalnya, Anda dapat memilih string yang menjelaskan driver perangkat, atau yang berisi nama perangkat. Anda dapat menggunakan ekstensi debugger !bugdump untuk menampilkan data crash dump yang terkait dengan string ini.

Nilai kembali

KeRegisterBugCheckReasonCallback mengembalikan TRUE jika rutinitas panggilan balik berhasil didaftarkan; jika tidak, ia mengembalikan FALSE.

Keterangan

Driver dapat menggunakan KeRegisterBugCheckReasonCallback untuk mendaftarkan rutinitas yang dijalankan selama pemeriksaan bug sistem.

Untuk deskripsi setiap jenis panggilan balik, lihat KBUGCHECK_CALLBACK_REASON.

Driver dapat menggunakan rutinitas KeDeregisterBugCheckReasonCallback untuk menghapus pendaftaran panggilan balik pemeriksaan bug. Setiap driver yang dapat dibongkar harus menghapus pendaftaran semua panggilan baliknya dalam rutinitas Bongkar .

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

Untuk menampilkan data cadangan sekunder, Anda dapat menggunakan metode IDebugDataSpaces3::ReadTagged** dalam ekstensi debugger. Opsi lain adalah men-debug rutinitas panggilan balik pemeriksaan bug itu sendiri. Untuk informasi selengkapnya tentang debugger dan ekstensi debugger, lihat Debugging Windows.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows XP Service Pack 1 (SP1), Windows Server 2003, dan versi Windows yang lebih baru.
Target Platform	Universal
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Tingkat apa pun