Fungsi EngBugCheckEx (winddi.h)

Fungsi EngBugCheckEx menurunkan sistem dengan cara yang terkontrol ketika pemanggil menemukan kesalahan yang tidak dapat dipulihkan yang akan merusak sistem jika pemanggil terus berjalan.

Sintaks

ENGAPI VOID EngBugCheckEx(
  [in] ULONG     BugCheckCode,
  [in] ULONG_PTR P1,
  [in] ULONG_PTR P2,
  [in] ULONG_PTR P3,
  [in] ULONG_PTR P4
);

Parameter

[in] BugCheckCode

Menentukan nilai yang menunjukkan alasan pemeriksaan bug.

[in] P1

Penunjuk ke nilai yang menyediakan informasi tambahan, seperti alamat dan data tempat terjadinya kesalahan kerusakan memori. Nilai tergantung pada nilai parameter BugCheckCode .

[in] P2

Penunjuk ke nilai yang menyediakan informasi tambahan, seperti alamat dan data tempat terjadinya kesalahan kerusakan memori. Nilai tergantung pada nilai parameter BugCheckCode .

[in] P3

Penunjuk ke nilai yang menyediakan informasi tambahan, seperti alamat dan data tempat terjadinya kesalahan kerusakan memori. Nilai tergantung pada nilai parameter BugCheckCode .

[in] P4

Penunjuk ke nilai yang menyediakan informasi tambahan, seperti alamat dan data tempat terjadinya kesalahan kerusakan memori. Nilai tergantung pada nilai parameter BugCheckCode .

Mengembalikan nilai

Tidak ada

Keterangan

Pemeriksaan bug adalah kesalahan yang terdeteksi sistem yang menyebabkan penonaktifan sistem langsung dan terkontrol. Ketika driver grafis menemukan kesalahan yang tidak dapat dipulihkan, itu harus menghasilkan pemeriksaan bug.

Driver grafis harus memanggil EngBugCheckEx hanya jika terjadi kesalahan fatal dan tidak dapat dipulihkan yang dapat merusak sistem. Jika memungkinkan, semua driver grafis harus mencatat kesalahan dan terus berjalan. Misalnya, jika driver tidak dapat mengalokasikan sumber daya yang diperlukan, driver harus mencatat kesalahan sehingga sistem terus berjalan; tidak boleh menghasilkan pemeriksaan bug.

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

Namun, bahkan selama pengembangan driver, rutinitas ini hanya untuk penggunaan 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	Fungsi ini tersedia di Microsoft Windows Server 2003 dan yang lebih baru.
Target Platform	Universal
Header	winddi.h (termasuk Winddi.h)
Pustaka	Win32k.lib
DLL	Win32k.sys