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