WDF_DEVICE_FAILED_ACTION-Enumeration (wdfdevice.h)
[Gilt für KMDF und UMDF]
Die WDF_DEVICE_FAILED_ACTION-Enumeration identifiziert die Aktion, die das Framework ausführen wird, wenn ein Treiber einen nicht wiederherstellbaren Software- oder Hardwarefehler meldet.
Syntax
typedef enum _WDF_DEVICE_FAILED_ACTION {
WdfDeviceFailedUndefined = 0,
WdfDeviceFailedAttemptRestart,
WdfDeviceFailedNoRestart
} WDF_DEVICE_FAILED_ACTION;
Konstanten
WdfDeviceFailedUndefinedWert: 0 Nur zur internen Verwendung. |
WdfDeviceFailedAttemptRestartUnterstützt in KMDF und ab UMDF-Version 2.15. Wenn die Gerätetreiber keine anderen Geräte unterstützen, die an den Computer angeschlossen sind, entlädt der E/A-Manager die Treiber. Als Nächstes versucht der Plug & Play-Manager, das Gerät neu zu starten, indem er den Bustreiber auffordert, seine Geräte erneut aufzulisten. Wenn der Bustreiber eine erneute Aufzählung unterstützt, wird Ihr Treiber erneut geladen, wenn er entladen wurde. Wenn mehrere aufeinanderfolgende Neustartversuche fehlschlagen (da der neu gestartete Treiber erneut einen Fehler meldet), beendet das Framework den Versuch, das Gerät neu zu starten. |
WdfDeviceFailedNoRestartWenn die Gerätetreiber andere Geräte im System nicht unterstützen, entladen die E/A-Manager die Treiber. |
Hinweise
Die WDF_DEVICE_FAILED_ACTION-Enumeration wird als Eingabeargument für WdfDeviceSetFailed verwendet.
Treiber geben in der Regel WdfDeviceFailedAttemptRestart an , wenn ein nicht behebbarer Softwarefehler auftritt, da die Angabe dieses Enumerators die Treiber erneut lädt. Ein Treiber kann WdfDeviceFailedNoRestart angeben, wenn ein nicht wiederherstellbarer Hardwarefehler auftritt, der sich auf alle Geräte des Treibers auswirkt.
Informationen zum Angeben von WdfDeviceFailedAttemptRestart in einem UMDF-Treiber finden Sie unter Hinweise zu WdfDeviceSetFailed.
Anforderungen
| Anforderung | Wert |
|---|---|
| KMDF-Mindestversion | 1.0 |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | wdfdevice.h (einschließen von Wdf.h) |