Fungsi WdfVerifierDbgBreakPoint (wdfverifier.h)

Artikel
03/01/2024

[Berlaku untuk KMDF dan UMDF]

Fungsi WdfVerifierDbgBreakPoint dipecah menjadi debugger kernel, jika debugger berjalan.

Sintaks

void WdfVerifierDbgBreakPoint();

Mengembalikan nilai

Tidak ada

Keterangan

Fungsi WdfVerifierDbgBreakPoint dipecah menjadi debugger kernel jika salah satu hal berikut ini benar:

DbgBreakOnError diatur ke nilai bukan nol dalam registri.
VerifierOn diatur ke nilai bukan nol dan DbgBreakOnError tidak diatur.
Driver Verifier diaktifkan, driver dibangun dengan kerangka kerja versi 1.9 atau yang lebih baru, dan VerifierOn maupun DbgBreakOnError tidak diatur.

Untuk informasi selengkapnya tentang entri registri yang dapat Anda gunakan untuk men-debug driver Anda, lihat Entri Registri untuk Penelusuran Kesalahan Framework-Based Driver.

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

Contoh

Contoh kode berikut menunjukkan bagaimana driver mungkin menangani kegagalan untuk mendapatkan buffer output permintaan I/O.

Status = WdfRequestRetrieveOutputMemory(
                                        Request,
                                        &memory
                                        );
if( !NT_SUCCESS(Status) ) {
    KdPrint(("EvtIoRead could not get request memory buffer. Status: 0x%x\n",Status));
    WdfVerifierDbgBreakPoint();
    WdfRequestCompleteWithInformation(
                                      Request,
                                      Status,
                                      0L
                                      );
    return;
}

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

WdfVerifierKeBugCheck

Bagikan melalui