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 除了在特定錯誤狀況下,架構會針對驅動程式列舉的所有子裝置呼叫驅動程式的 EvtDeviceReleiceReleaseHardware 回呼函式之後,呼叫 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) |