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

Статья
02/07/2025

[Применимо к 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 (include Wdf.h)

См. также

WdfDeviceSetFailed

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