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