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 开始。 如果设备的驱动程序不支持插入计算机的其他设备,则 I/O 管理器将卸载驱动程序。 接下来,即插即用管理器尝试通过请求总线驱动程序重新启用其设备来重启设备。 如果总线驱动程序支持重新实例化,则会重新加载驱动程序(如果已卸载)。 如果 (多次连续重启尝试失败,因为重新启动的驱动程序再次报告错误) ,框架将停止尝试重启设备。
WdfDeviceFailedNoRestart
如果设备的驱动程序不支持系统上的其他设备,则 I/O 管理器将卸载驱动程序。

注解

WDF_DEVICE_FAILED_ACTION枚举用作 WdfDeviceSetFailed 的输入参数。

如果驱动程序遇到不可恢复的软件错误,通常会指定 WdfDeviceFailedAttemptRestart ,因为指定此枚举器会重新加载驱动程序。 如果驱动程序遇到影响驱动程序所有设备的不可恢复硬件错误,则驱动程序可能会指定 WdfDeviceFailedNoRestart

有关在 UMDF 驱动程序中指定 WdfDeviceFailedAttemptRestart 的信息,请参阅 WdfDeviceSetFailed 的备注。

要求

要求
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
标头 wdfdevice.h (包括 Wdf.h)

另请参阅

WdfDeviceSetFailed