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

Функция EngHangNotification (winddi.h)

  • Статья

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

Синтаксис

ENGAPI ULONG EngHangNotification(
  HDEV  hdev,
  PVOID Reserved
);

Параметры

hdev

Дескриптор для остановленного физического устройства. Этот параметр является дескриптором GDI, полученным точкой входа DrvCompletePDEV драйвера.

Reserved

Зарезервировано и должно иметь значение NULL.

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

EngHangNotification возвращает одно из следующих значений:

Код возврата Описание
EHN_ERROR
 Устройство не восстановилось после ошибки.
EHN_RESTORED
 Устройство было восстановлено в рабочем состоянии.

Комментарии

Драйвер должен выполнять этот вызов каждый раз, когда обнаруживает, что оборудование не работает или не отвечает. Если EngHangNotification возвращает EHN_RESTORED, драйвер должен повторить операцию, которая обнаружила неработоспособное состояние; в противном случае драйвер должен как можно скорее завершить текущий вызов. Все последующие операции драйвера, которые обнаруживают проблему, должны снова вызывать EngHangNotification.

Требования

Требование Значение
Минимальная версия клиента Эта функция доступна в Windows XP и более поздних версиях.
Целевая платформа Универсальное
Верхняя часть winddi.h (включая Winddi.h)
Библиотека Win32k.lib
DLL Win32k.sys

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

DrvCompletePDEV

DrvResetDevice