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

Функция 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

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

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

Никакой

Замечания

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

Если драйвер User-Mode Driver Framework (UMDF) (версия 2.0 или более поздней) вызывает WdfVerifierKeBugCheck, платформа не использует параметры, которые предоставляет драйвер. В этом случае платформа разбивается на отладчик, если он подключен. Если отладчик не подключен, платформа создает исключение, а обработчик исключений UMDF по умолчанию создает мини-файл. Дополнительные сведения об необработанных исключениях в процессе узла драйвера см. в отчета об ошибках 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 (include Wdf.h)
библиотеки Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL Любой уровень
правил соответствия DDI DriverCreate(kmdf)

См. также

WdfVerifierDbgBreakPoint