Fungsi DbgBreakPointWithStatus (wdm.h)

  • Artikel

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)

Lihat juga

DbgBreakPoint

KdBreakPoint

KdBreakPointWithStatus