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) |