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