Функция WdfVerifierDbgBreakPoint (wdfverifier.h)

Статья
02/07/2025

[Применимо к KMDF и UMDF]

Функция WdfVerifierDbgBreakPoint прерывается в отладчик ядра, если выполняется отладчик.

Синтаксис

void WdfVerifierDbgBreakPoint();

Возвращаемое значение

Никакой

Замечания

Функция WdfVerifierDbgBreakPoint прерывается в отладчик ядра, если одно из следующих значений имеет значение true:

dbgBreakOnError имеет значение, отличное от нуля в реестре.
VerifierOn имеет значение, отличное от нуля, и dbgBreakOnError не задано.
Средство проверки драйверов включено, драйвер был создан с платформой версии 1.9 или более поздней, и ни VerifierOn, ни DbgBreakOnError.

Дополнительные сведения о записях реестра, которые можно использовать для отладки драйвера, см. в записях реестра для отладки Framework-Based драйверов.

Дополнительные сведения об отладке драйвера см. в отладке драйвера KMDF.

Примеры

В следующем примере кода показано, как драйвер может справиться с ошибкой получения выходного буфера запроса ввода-вывода.

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;
}

Требования

Требование	Ценность
целевая платформа	Всеобщий
минимальная версия KMDF	1.0
минимальная версия UMDF	2.0
заголовка	wdfverifier.h (include Wdf.h)
библиотеки	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	Любой уровень
правил соответствия DDI	DriverCreate(kmdf)

См. также

WdfVerifierKeBugCheck

Поделиться через