WDF_DEVICE_FAILED_ACTION enumeración (wdfdevice.h)

  • Artículo

[Se aplica a KMDF y UMDF]

La enumeración WDF_DEVICE_FAILED_ACTION identifica la acción que realizará el marco cuando un controlador notifica un error de hardware o software irrecuperable.

Syntax

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

Constantes

 
WdfDeviceFailedUndefined
Valor: 0
Solo para uso interno.
WdfDeviceFailedAttemptRestart
Compatible con KMDF y a partir de la versión 2.15 de UMDF. Si los controladores del dispositivo no admiten otros dispositivos conectados al equipo, el administrador de E/S descarga los controladores. A continuación, el administrador de Plug and Play intenta reiniciar el dispositivo solicitando al controlador de autobús que vuelva aumer sus dispositivos. Si el controlador de autobús admite la reenumeración, el controlador se volverá a cargar, si se ha descargado. Si se produce un error en varios intentos de reinicio consecutivos (porque el controlador reiniciado de nuevo notifica un error), el marco deja de intentar reiniciar el dispositivo.
WdfDeviceFailedNoRestart
Si los controladores del dispositivo no admiten otros dispositivos en el sistema, el administrador de E/S descarga los controladores.

Comentarios

La enumeración WDF_DEVICE_FAILED_ACTION se usa como argumento de entrada para WdfDeviceSetFailed.

Normalmente, los controladores especifican WdfDeviceFailedAttemptRestart si encuentran un error de software irrecuperable, ya que al especificar este enumerador se vuelven a cargar los controladores. Un controlador puede especificar WdfDeviceFailedNoRestart si encuentra un error de hardware irrecuperable que afecta a todos los dispositivos del controlador.

Para obtener información sobre cómo especificar WdfDeviceFailedAttemptRestart en un controlador UMDF, vea los comentarios de WdfDeviceSetFailed.

Requisitos

Requisito Value
Versión mínima de KMDF 1.0
Versión mínima de UMDF 2.0
Encabezado wdfdevice.h (incluya Wdf.h)

Consulte también

WdfDeviceSetFailed