перечисление WDF_DEVICE_FAILED_ACTION (wdfdevice.h)

  • Статья

[Применимо к KMDF и UMDF]

Перечисление WDF_DEVICE_FAILED_ACTION определяет действие, которое будет предпринять платформа, когда драйвер сообщает о неустранимом программном или аппаратном сбое.

Синтаксис

typedef enum _WDF_DEVICE_FAILED_ACTION {
  WdfDeviceFailedUndefined = 0,
  WdfDeviceFailedAttemptRestart,
  WdfDeviceFailedNoRestart
} WDF_DEVICE_FAILED_ACTION;

Константы

 
WdfDeviceFailedUndefined
Значение: 0
Только для внутреннего использования.
WdfDeviceFailedAttemptRestart
Поддерживается в KMDF и начиная с UMDF версии 2.15. Если драйверы устройства не поддерживают другие устройства, подключенные к компьютеру, диспетчер ввода-вывода выгружает драйверы. Затем Plug and Play-менеджер пытается перезапустить устройство, запрашивая у водителя шины повторное обновление устройств. Если драйвер шины поддерживает повторную настройку, драйвер будет перезагружен, если он был выгружен. Если несколько последовательных попыток перезапуска завершаются сбоем (так как перезапущенный драйвер снова сообщает об ошибке), платформа перестает пытаться перезапустить устройство.
WdfDeviceFailedNoRestart
Если драйверы устройства не поддерживают другие устройства в системе, диспетчер ввода-вывода выгрузит драйверы.

Комментарии

Перечисление WDF_DEVICE_FAILED_ACTION используется в качестве входного аргумента для WdfDeviceSetFailed.

Драйверы обычно указывают WdfDeviceFailedAttemptRestart , если возникает неустранимая ошибка программного обеспечения, так как указание этого перечислителя перезагружает драйверы. Драйвер может указать WdfDeviceFailedNoRestart , если обнаруживает неустранимую аппаратную ошибку, которая затрагивает все устройства драйвера.

Сведения об указании WdfDeviceFailedAttemptRestart в драйвере UMDF см. в разделе Примечания WdfDeviceSetFailed.

Требования

Требование Значение
Минимальная версия KMDF 1,0
Минимальная версия UMDF 2,0
Верхняя часть wdfdevice.h (включая Wdf.h)

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

WdfDeviceSetFailed