Fungsi DbgBreakPointWithStatus (wdm.h)
Rutinitas DbgBreakPointWithStatus masuk ke debugger kernel dan mengirim nilai Status ke debugger.
Sintaks
__analysis_noreturn NTSYSAPI VOID DbgBreakPointWithStatus(
[in] ULONG Status
);
Parameter
[in] Status
Menentukan nilai ULONG yang dikirim ke debugger (misalnya, kode status atau alamat).
Nilai kembali
Tidak ada
Keterangan
DbgBreakPointWithStatus identik dengan DbgBreakPoint, kecuali untuk pesan Status .
Pada komputer x86, parameter Status disimpan dalam register eax . Pada komputer yang telah mendaftarkan konvensi panggilan, Status disimpan dalam register argumen pertama.
Rutinitas ini menimbulkan pengecualian yang ditangani oleh debugger kernel jika dipasang; jika tidak, itu ditangani oleh sistem debug. Jika debugger tidak terhubung ke sistem, pengecualian dapat ditangani dengan cara standar.
Dalam mode kernel, pengecualian jeda yang tidak ditangani akan menyebabkan pemeriksaan bug. Namun, Anda dapat menyambungkan debugger mode kernel ke komputer target yang berhenti merespons dan mengaktifkan penelusuran kesalahan kernel. Untuk informasi selengkapnya, lihat Penelusuran Kesalahan Windows.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Tersedia di Microsoft Windows 2000 dan yang lebih baru. |
Target Platform | Universal |
Header | wdm.h (termasuk Wdm.h, Ntddk.h) |
Pustaka | Ntdll.lib (mode pengguna); NtosKrnl.lib (mode kernel) |
DLL | NtosKrnl.exe |
Aturan kepatuhan DDI | DebugBreakUsage(wdm), HwStorPortProhibitedDDIs(storport) |