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

  • Статья

[Относится к KMDF и UMDF]

Функция WdfVerifierKeBugCheck создает проверка ошибок.

Синтаксис

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

Параметры

[in] BugCheckCode

Один из проверка ошибок кодов, определенных в Bugcodes.h.

[in] BugCheckParameter1

Сведения об этом параметре см. в описании указанного проверка кода ошибки.

[in] BugCheckParameter2

Сведения об этом параметре см. в описании указанного проверка кода ошибки.

[in] BugCheckParameter3

Сведения об этом параметре см. в описании указанного проверка кода ошибки.

[in] BugCheckParameter4

Сведения об этом параметре см. в описании указанного проверка кода ошибки.

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

None

Remarks

Если драйвер Kernel-Mode Driver Framework (KMDF) вызывает WdfVerifierKeBugCheck, операционная система останавливается и отображает синий экран , если не запущен отладчик .

Если драйвер User-Mode Driver Framework (UMDF) (версии 2.0 или более поздней) вызывает WdfVerifierKeBugCheck, платформа не использует параметры, которые предоставляет драйвер. В этом случае платформа прерывается в отладчик, если он подключен. Если отладчик не подключен, платформа создает исключение, а обработчик исключений UMDF по умолчанию создает файл minidump. Дополнительные сведения о необработанных исключениях в хост-процессе драйвера см. в разделе Как UMDF сообщает об ошибках.

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

Примеры

В следующем примере кода создается проверка ошибок, использующий MULTIPLE_IRP_COMPLETE_REQUESTS проверка код ошибки.

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

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1,0
Минимальная версия UMDF 2,0
Верхняя часть wdfverifier.h (включая Wdf.h)
Библиотека Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL Любой уровень
Правила соответствия DDI DriverCreate(kmdf)

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

WdfVerifierDbgBreakPoint