次の方法で共有

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
ヘッダー wdfdevice.h (Wdf.h を含む)

関連項目

WdfDeviceSetFailed の