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

WdfDeviceFailedUndefined Wert: 0 Nur zur internen Verwendung.
WdfDeviceFailedAttemptRestart Unterstü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.
WdfDeviceFailedNoRestart Wenn 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)

Weitere Informationen

WdfDeviceSetFailed