Fungsi KeRegisterBugCheckCallback (wdm.h)

  • Artikel

Rutinitas KeRegisterBugCheckCallback mendaftarkan rutinitas BugCheckCallback , yang dijalankan ketika sistem operasi mengeluarkan pemeriksaan bug.

Sintaks

BOOLEAN KeRegisterBugCheckCallback(
  [out]          PKBUGCHECK_CALLBACK_RECORD  CallbackRecord,
  [in]           PKBUGCHECK_CALLBACK_ROUTINE CallbackRoutine,
  [in, optional] PVOID                       Buffer,
  [in]           ULONG                       Length,
  [in]           PUCHAR                      Component
);

Parameter

[out] CallbackRecord

Penunjuk ke rekaman panggilan balik yang sebelumnya diinisialisasi oleh KeInitializeCallbackRecord, yang pemanggilnya menyediakan penyimpanan yang tidak disebarkan.

[in] CallbackRoutine

Penunjuk ke fungsi panggilan balik KBUGCHECK_CALLBACK_ROUTINE yang disediakan driver.

[in, optional] Buffer

Penunjuk ke buffer yang disediakan penelepon, yang harus berada dalam memori penduduk, seperti kumpulan yang tidak dipagasi.

[in] Length

Menentukan ukuran dalam byte buffer yang dialokasikan pemanggil.

[in] Component

Penunjuk ke string ANSI yang dihentikan null yang mengidentifikasi pemanggil. String ini biasanya berisi nama driver perangkat, atau mungkin dari perangkatnya.

Nilai kembali

KeRegisterBugCheckCallback mengembalikan TRUE jika rutinitas yang disediakan pemanggil berhasil ditambahkan ke kumpulan panggilan balik pemeriksaan bug terdaftar; jika tidak, ia mengembalikan FALSE.

Keterangan

Rutinitas KeRegisterBugCheckCallback mendaftarkan rutinitas BugCheckCallback, jenis rutinitas panggilan balik pemeriksaan bug paling sederhana.

Untuk mendaftarkan jenis panggilan balik pemeriksaan bug lainnya, seperti rutinitas KbCallbackDumpIo dan KbCallbackAddPages, gunakan rutinitas KeRegisterBugCheckReasonCallback sebagai gantinya.

Rutinitas BugCheckCallback dijalankan ketika sistem mengeluarkan pemeriksaan bug. Driver dapat menggunakan rutinitas untuk mengatur ulang perangkat ke keadaan yang diketahui. Untuk informasi selengkapnya, lihat BugCheckCallback.

Driver dapat menggunakan rutinitas KeDeregisterBugCheckCallback untuk menghapus panggilan balik. Setiap driver yang dapat dibongkar harus menghapus semua panggilan baliknya dalam rutinitas Bongkar .

String Komponen digunakan untuk mengidentifikasi driver selama debugging crash-dump. Untuk menampilkan data crash dump yang sesuai dengan string Komponen yang ditentukan, Anda dapat menggunakan ekstensi debugger !bugdump . Dimungkinkan juga untuk men-debug rutinitas panggilan balik pemeriksaan bug itu sendiri. Untuk informasi tentang debugger dan ekstensi debugger, lihat Windows Debugging.

Implementasi

Untuk menentukan rutinitas panggilan balik BugCheckCallback, Anda harus terlebih dahulu memberikan deklarasi fungsi yang mengidentifikasi jenis rutinitas panggilan balik yang Anda tentukan. Windows menyediakan sekumpulan tipe fungsi panggilan balik untuk driver. Mendeklarasikan fungsi menggunakan jenis fungsi panggilan balik membantu Analisis Kode untuk Driver, Pemverifikasi Driver Statis (SDV), dan alat verifikasi lainnya menemukan kesalahan.

Misalnya, untuk menentukan rutinitas panggilan balik BugCheckCallback yang bernama MyBugCheckCallback, gunakan jenis KBUGCHECK_CALLBACK_ROUTINE seperti yang ditunjukkan dalam contoh kode ini:

KBUGCHECK_CALLBACK_ROUTINE MyBugCheckCallback;

Kemudian, terapkan rutinitas panggilan balik Anda sebagai berikut:

_Use_decl_annotations_
VOID
  MyBugCheckCallback(
    PVOID  Buffer,
    ULONG  Length
    )
  {
      // Function body
  }

Jenis fungsi KBUGCHECK_CALLBACK_ROUTINE didefinisikan dalam file header Wdm.h.

Untuk mengidentifikasi kesalahan secara lebih akurat saat Anda menjalankan alat analisis kode, pastikan untuk menambahkan ke _Use_decl_annotations_ annotation definisi fungsi Anda. Anotasi Use_decl_annotations memastikan bahwa anotasi yang diterapkan ke jenis fungsi KBUGCHECK_CALLBACK_ROUTINE dalam file header digunakan. Untuk informasi selengkapnya tentang persyaratan untuk deklarasi fungsi, lihat Mendeklarasikan Fungsi dengan Menggunakan Jenis Peran Fungsi untuk Driver WDM. Untuk informasi tentang Use_decl_annotations, lihat Perilaku Fungsi Anotasi.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows 2000.
Target Platform Universal
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Tingkat apa pun

Lihat juga

Menulis Bug Check Callback Routine.

KeDeregisterBugCheckCallback

KeInitializeCallbackRecord

KeRegisterBugCheckReasonCallback