enumerazione WDF_DEVICE_FAILED_ACTION (wdfdevice.h)

Articolo
02/07/2025

[Si applica a KMDF e UMDF]

L'enumerazione WDF_DEVICE_FAILED_ACTION identifica l'azione che verrà eseguita dal framework quando un driver segnala un errore hardware o software irreversibile.

Sintassi

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

Costanti


`WdfDeviceFailedUndefined` Valore: 0 Solo per uso interno.
`WdfDeviceFailedAttemptRestart` Supportato in KMDF e a partire da UMDF versione 2.15. Se i driver del dispositivo non supportano altri dispositivi collegati al computer, il gestore di I/O scarica i driver. Successivamente, il gestore Plug and Play tenta di riavviare il dispositivo richiedendo al driver del bus di riesenumerare i propri dispositivi. Se il driver del bus supporta la rinumerazione, il driver verrà ricaricato, se è stato scaricato. Se diversi tentativi di riavvio consecutivi hanno esito negativo (perché il driver riavviato segnala di nuovo un errore), il framework smette di tentare di riavviare il dispositivo.
`WdfDeviceFailedNoRestart` Se i driver del dispositivo non supportano altri dispositivi nel sistema, il gestore di I/O scarica i driver.

Osservazioni

L'enumerazione WDF_DEVICE_FAILED_ACTION viene usata come argomento di input per WdfDeviceSetFailed.

I driver specificano in genere WdfDeviceFailedAttemptRestart se si verifica un errore software irreversibile, perché specificando questo enumeratore ricarica i driver. Un driver potrebbe specificare WdfDeviceFailedNoRestart se rileva un errore hardware irreversibile che interessa tutti i dispositivi del driver.

Per informazioni sulla specifica di WdfDeviceFailedAttemptRestart in un driver UMDF, vedere la sezione Osservazioni di WdfDeviceSetFailed.

Fabbisogno

Requisito	Valore
versione minima di KMDF	1.0
versione minima di UMDF	2.0
intestazione	wdfdevice.h (include Wdf.h)

Vedere anche

WdfDeviceSetFailed

Condividi tramite