次の方法で共有


WDF_DEVICE_FAILED_ACTION列挙 (wdfdevice.h)

[KMDF と UMDF に適用]

WDF_DEVICE_FAILED_ACTION列挙は、ドライバーが回復不可能なソフトウェアまたはハードウェアの障害を報告したときにフレームワークが実行するアクションを識別します。

構文

typedef enum _WDF_DEVICE_FAILED_ACTION {
  WdfDeviceFailedUndefined = 0,
  WdfDeviceFailedAttemptRestart,
  WdfDeviceFailedNoRestart
} WDF_DEVICE_FAILED_ACTION;

定数

 
WdfDeviceFailedUndefined
値: 0
内部使用専用です。
WdfDeviceFailedAttemptRestart
KMDF でサポートされ、UMDF バージョン 2.15 以降でサポートされます。 デバイスのドライバーがコンピューターに接続されている他のデバイスをサポートしていない場合、I/O マネージャーはドライバーをアンロードします。 次に、プラグ アンド プレイ マネージャーは、バス ドライバーにデバイスの再有効化を要求して、デバイスの再起動を試みます。 バス ドライバーが再開をサポートしている場合、ドライバーがアンロードされた場合、ドライバーは再読み込みされます。 数回の連続した再起動試行が失敗した場合 (再起動されたドライバーが再度エラーを報告するため)、フレームワークはデバイスの再起動を停止します。
WdfDeviceFailedNoRestart
デバイスのドライバーがシステム上の他のデバイスをサポートしていない場合、I/O マネージャーはドライバーをアンロードします。

注釈

WDF_DEVICE_FAILED_ACTION列挙は、 WdfDeviceSetFailed への入力引数として使用されます。

ドライバーは通常、この列挙子を指定するとドライバーが再読み込みされるため、回復不可能なソフトウェア エラーが発生した場合に WdfDeviceFailedAttemptRestart を指定します。 ドライバーは、すべてのドライバーのデバイスに影響を与える回復不可能なハードウェア エラーが発生した場合に WdfDeviceFailedNoRestart を指定する可能性があります。

UMDF ドライバーで WdfDeviceFailedAttemptRestart を指定する方法については、「 WdfDeviceSetFailed の解説」を参照してください。

要件

要件
最小 KMDF バージョン 1.0
最小 UMDF バージョン 2.0
Header wdfdevice.h (Wdf.h を含む)

こちらもご覧ください

WdfDeviceSetFailed