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

Статья
02/29/2024

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

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

Синтаксис

void WdfVerifierDbgBreakPoint();

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

None

Remarks

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

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 (включая Wdf.h)
Библиотека	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	Любой уровень
Правила соответствия DDI	DriverCreate(kmdf)

См. также раздел

WdfVerifierKeBugCheck

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