enumeração WDF_DEVICE_FAILED_ACTION (wdfdevice.h)

  • Artigo

[Aplica-se a KMDF e UMDF]

A enumeração WDF_DEVICE_FAILED_ACTION identifica a ação que a estrutura tomará quando um driver relatar uma falha de hardware ou software irrecuperável.

Syntax

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

Constantes

 
WdfDeviceFailedUndefined
Valor: 0
Apenas para uso interno.
WdfDeviceFailedAttemptRestart
Com suporte no KMDF e começando na UMDF versão 2.15. Se os drivers do dispositivo não estiverem dando suporte a outros dispositivos conectados ao computador, o gerente de E/S descarregará os drivers. Em seguida, o gerenciador de Plug and Play tenta reiniciar o dispositivo solicitando que o motorista do ônibus reenumere seus dispositivos. Se o motorista do ônibus der suporte à reenumeração, o motorista será recarregado, se ele tiver sido descarregado. Se várias tentativas de reinicialização consecutivas falharem (porque o driver reiniciado relata novamente um erro), a estrutura para de tentar reiniciar o dispositivo.
WdfDeviceFailedNoRestart
Se os drivers do dispositivo não estiverem dando suporte a outros dispositivos no sistema, o gerente de E/S descarregará os drivers.

Comentários

A enumeração WDF_DEVICE_FAILED_ACTION é usada como um argumento de entrada para WdfDeviceSetFailed.

Os drivers normalmente especificam WdfDeviceFailedAttemptRestart se encontrarem um erro de software irrecuperável, pois especificar esse enumerador recarrega os drivers. Um driver poderá especificar WdfDeviceFailedNoRestart se encontrar um erro de hardware irrecuperável que afete todos os dispositivos do driver.

Para obter informações sobre como especificar WdfDeviceFailedAttemptRestart em um driver UMDF, consulte os Comentários de WdfDeviceSetFailed.

Requisitos

Requisito Valor
Versão mínima do KMDF 1.0
Versão mínima do UMDF 2,0
Cabeçalho wdfdevice.h (inclua Wdf.h)

Confira também

WdfDeviceSetFailed