Fungsi WdfVerifierKeBugCheck (wdfverifier.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Fungsi WdfVerifierKeBugCheck membuat pemeriksaan bug.

Sintaks

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

Parameter

[in] BugCheckCode

Salah satu kode pemeriksaan bug yang didefinisikan dalam Bugcodes.h.

[in] BugCheckParameter1

Untuk informasi tentang parameter ini, lihat deskripsi kode pemeriksaan bug yang ditentukan.

[in] BugCheckParameter2

Untuk informasi tentang parameter ini, lihat deskripsi kode pemeriksaan bug yang ditentukan.

[in] BugCheckParameter3

Untuk informasi tentang parameter ini, lihat deskripsi kode pemeriksaan bug yang ditentukan.

[in] BugCheckParameter4

Untuk informasi tentang parameter ini, lihat deskripsi kode pemeriksaan bug yang ditentukan.

Nilai kembali

Tidak ada

Keterangan

Jika driver Kernel-Mode Driver Framework (KMDF) Anda memanggil WdfVerifierKeBugCheck, sistem operasi menghentikan dan menampilkan layar biru kecuali debugger berjalan.

Jika driver User-Mode Driver Framework (UMDF) Anda (versi 2.0 atau yang lebih baru) memanggil WdfVerifierKeBugCheck, kerangka kerja tidak menggunakan parameter yang disediakan driver. Dalam hal ini, kerangka kerja memecah ke debugger jika satu terhubung. Jika debugger tidak tersambung, kerangka kerja menghasilkan pengecualian, dan handler pengecualian UMDF default membuat file minidump. Untuk informasi selengkapnya tentang pengecualian yang tidak tertangani dalam proses host driver, lihat Bagaimana UMDF Melaporkan Kesalahan.

Untuk informasi selengkapnya tentang penelusuran kesalahan driver Anda, lihat Men-debug Driver WDF.

Contoh

Contoh kode berikut membuat pemeriksaan bug yang menggunakan kode pemeriksaan bug MULTIPLE_IRP_COMPLETE_REQUESTS .

WdfVerifierKeBugCheck(
                      MULTIPLE_IRP_COMPLETE_REQUESTS,
                      (ULONG_PTR) irp,
                      (ULONG_PTR) srb,
                      0,
                      0
                      );

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Versi UMDF minimum 2.0
Header wdfverifier.h (termasuk Wdf.h)
Pustaka Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL Tingkat apa pun
Aturan kepatuhan DDI DriverCreate(kmdf)

Lihat juga

WdfVerifierDbgBreakPoint