共用方式為

WDF_DEVICE_FAILED_ACTION列舉 (wdfdevice.h)

  • 發行項

[適用於 KMDF 和 UMDF]

WDF_DEVICE_FAILED_ACTION列舉會識別驅動程式回報無法復原的軟體或硬體失敗時，架構將採取的動作。

Syntax

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