共用方式為

WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE列舉 (wdfdevice.h)

  • 發行項

[適用於 KMDF 和 UMDF]

WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE列舉會指定架構何時呼叫驅動程式的 EvtDeviceReleaseHardware 回呼函式。

Syntax

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