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 の