次の方法で共有


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
特定のエラー条件下を除き、ドライバーが列挙するすべての子デバイスに対して 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