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

[Применимо к 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