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

  • Статья

[Относится к KMDF и UMDF]

Перечисление WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE указывает, когда платформа вызывает функцию обратного вызова EvtDeviceReleaseHardware драйвера.

Синтаксис

typedef enum _WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE {
  WdfReleaseHardwareOrderOnFailureInvalid = 0,
  WdfReleaseHardwareOrderOnFailureEarly,
  WdfReleaseHardwareOrderOnFailureAfterDescendants
} WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE, *PWDF_RELEASE_HARDWARE_ORDER_ON_FAILURE;

Константы

 
WdfReleaseHardwareOrderOnFailureInvalid
Значение: 0
Зарезервировано для системного использования.
WdfReleaseHardwareOrderOnFailureEarly
За исключением определенных условий ошибки, платформа вызывает функцию обратного вызова EvtDeviceReleaseHardware драйвера после вызова функции EvtDeviceReleaseHardware для всех дочерних устройств, которые перечисляет драйвер. Дополнительные сведения см. в подразделе "Примечания".
WdfReleaseHardwareOrderOnFailureAfterDescendants
Платформа всегда вызывает функцию обратного вызова EvtDeviceReleaseHardware драйвера после вызова функции EvtDeviceReleaseHardware для всех дочерних устройств, которые перечисляет драйвер.

Комментарии

Перечисление WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE используется в качестве входных данных для WdfDeviceInitSetReleaseHardwareOrderOnFailure.

Если драйвер указывает WdfReleaseHardwareOrderOnFailureEarly, то при обычном удалении устройства платформа вызывает EvtDeviceReleaseHardware драйвера после вызова функции EvtDeviceReleaseHardware для всех дочерних устройств, перечисляемых драйвером. Однако в случае сбоя питания или выключения устройства платформа может вызвать evtDeviceReleaseHardware драйвера, прежде чем вызывать функции EvtDeviceReleaseHardware для всех дочерних устройств.

Если драйвер указывает WdfReleaseHardwareOrderOnFailureAfterDescendants, то платформа ожидает вызова evtDeviceReleaseHardware драйвера, пока не вызовет функции EvtDeviceReleaseHardware дочерних устройств.

Требования

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

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

EvtDeviceReleaseHardware

WdfDeviceInitSetReleaseHardwareOrderOnFailure