enumerazione WDF_DEVICE_FAILED_ACTION (wdfdevice.h)

Articolo
06/01/2023

[Si applica a KMDF e UMDF]

L'enumerazione WDF_DEVICE_FAILED_ACTION identifica l'azione eseguita dal framework quando un driver segnala un errore software o hardware non recuperabile.

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 dalla versione 2.15 di UMDF. Se i driver del dispositivo non supportano altri dispositivi collegati al computer, la gestione I/O scarica i driver. Successivamente, il gestore Plug and Play tenta di riavviare il dispositivo richiedendo al driver del bus di rinumerare 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 riavviare il dispositivo.
`WdfDeviceFailedNoRestart` Se i driver del dispositivo non supportano altri dispositivi nel sistema, il gestore di I/O scarica i driver.

Commenti

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

I driver specificano in genere WdfDeviceFailedAttemptRestart se riscontrano un errore software non recuperabile, perché specificando questo enumeratore ricarica i driver. Un driver potrebbe specificare WdfDeviceFailedNoRestart se si verifica un errore hardware non recuperabile che influisce su tutti i dispositivi del driver.

Per informazioni sulla specifica di WdfDeviceFailedAttemptRestart in un driver UMDF, vedere le osservazioni di WdfDeviceSetFailed.

Requisiti

Requisito	Valore
Versione KMDF minima	1.0
Versione UMDF minima	2,0
Intestazione	wdfdevice.h (includere Wdf.h)

Vedi anche

WdfDeviceSetFailed

Condividi tramite