Fungsi KeBugCheckEx (wdm.h)

  • Artikel

Rutinitas KeBugCheckEx menurunkan sistem dengan cara yang terkontrol ketika penelepon menemukan ketidakkonsistensi yang tidak dapat dipulihkan yang akan merusak sistem jika pemanggil terus berjalan.

Sintaks

void KeBugCheckEx(
  [in] ULONG     BugCheckCode,
  [in] ULONG_PTR BugCheckParameter1,
  [in] ULONG_PTR BugCheckParameter2,
  [in] ULONG_PTR BugCheckParameter3,
  [in] ULONG_PTR BugCheckParameter4
);

Parameter

[in] BugCheckCode

Menentukan nilai yang menunjukkan alasan pemeriksaan bug.

[in] BugCheckParameter1

[in] BugCheckParameter2

[in] BugCheckParameter3

[in] BugCheckParameter4

Empat nilai BugCheckParameterX menyediakan informasi tambahan, seperti alamat dan data tempat kesalahan kerusakan memori terjadi, tergantung pada nilai BugCheckCode.

Nilai kembali

Tidak ada

Keterangan

Pemeriksaan bug adalah kesalahan yang terdeteksi sistem yang menyebabkan penonaktifan sistem langsung dan terkontrol. Berbagai komponen mode kernel melakukan pemeriksaan konsistensi run-time. Ketika komponen seperti itu menemukan ketidakkonsistensi yang tidak dapat dipulihkan, itu menyebabkan pemeriksaan bug dihasilkan.

Jika memungkinkan, semua komponen mode kernel harus mencatat kesalahan dan terus berjalan, daripada memanggil KeBugCheckEx. Misalnya, jika driver tidak dapat mengalokasikan sumber daya yang diperlukan, driver harus mencatat kesalahan sehingga sistem terus berjalan; tidak boleh menghasilkan pemeriksaan bug.

Driver atau komponen mode kernel lainnya harus memanggil rutinitas ini hanya dalam kasus kesalahan fatal yang tidak dapat dipulihkan yang dapat merusak sistem itu sendiri.

KeBugCheckEx dapat berguna pada tahap awal pengembangan driver, atau saat sedang menjalani pengujian. Dalam keadaan ini, BugCheckCode yang diteruskan ke rutinitas ini harus berbeda dari kode-kode yang sudah digunakan oleh Windows atau drivernya. Untuk daftar kode ini, lihat Kode Pemeriksaan Bug.

Namun, bahkan selama pengembangan driver, rutinitas ini hanya dari utilitas terbatas, karena mengakibatkan pematian sistem yang lengkap. Metode penelusuran kesalahan yang lebih efektif adalah melampirkan debugger kernel ke sistem lalu menggunakan rutinitas yang mengirim pesan ke debugger atau masuk ke debugger. Untuk informasi selengkapnya, lihat Menggunakan Kode Debugging di Driver.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Windows 2000 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

Lihat juga

IoAllocateErrorLogEntry

IoWriteErrorLogEntry

KeBugCheck

KeRegisterBugCheckCallback

KeRegisterBugCheckReasonCallback