共用方式為


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)

另請參閱

EvtDeviceReleaseHardware

WdfDeviceInitSetReleaseHardwareOrderOnFailure