Функция 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) |
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по