WDF_DEVICE_FAILED_ACTION-Aufzählung (wdfdevice.h)

Artikel
02/07/2025

[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 behebbaren Software- oder Hardwarefehler meldet.

Syntax

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

Konstanten


`WdfDeviceFailedUndefined` Wert: 0 Nur für die interne Verwendung.
`WdfDeviceFailedAttemptRestart` Unterstützt in KMDF und ab UMDF, Version 2.15. Wenn die Treiber des Geräts 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 and Play-Manager, das Gerät neu zu starten, indem der Bustreiber aufgefordert wird, seine Geräte erneut auflisten zu können. Wenn der Bustreiber die Erneute Aufzählung unterstützt, wird der Treiber neu geladen, wenn er entladen wurde. Wenn mehrere aufeinander folgende Neustartversuche fehlschlagen (da der neu gestartete Treiber erneut einen Fehler meldet), versucht das Framework nicht mehr, das Gerät neu zu starten.
`WdfDeviceFailedNoRestart` Wenn die Treiber des Geräts andere Geräte auf dem System nicht unterstützen, entlädt der E/A-Manager die Treiber.

Bemerkungen

Die WDF_DEVICE_FAILED_ACTION-Aufzählung wird als Eingabeargument zum WdfDeviceSetFailed-verwendet.

Treiber geben in der Regel WdfDeviceFailedAttemptRestart- an, wenn ein nicht behebbarer Softwarefehler auftritt, da durch Angeben dieses Enumerators die Treiber neu geladen werden. Ein Treiber kann WdfDeviceFailedNoRestart- angeben, wenn ein nicht behebbarer Hardwarefehler auftritt, der sich auf alle Geräte des Treibers auswirkt.

Informationen zum Angeben WdfDeviceFailedAttemptRestart- in einem UMDF-Treiber finden Sie in den Anmerkungen zu WdfDeviceSetFailed.

Anforderungen

Anforderung	Wert
Minimale KMDF-Version	1.0
Mindest-UMDF-Version	2.0
Header-	wdfdevice.h (einschließen Wdf.h)

Siehe auch

WdfDeviceSetFailed-

Freigeben über