enumeração WDF_DEVICE_FAILED_ACTION (wdfdevice.h)

[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.

Sintaxe

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

Constantes

WdfDeviceFailedUndefined Valor: 0 Somente para uso interno.
WdfDeviceFailedAttemptRestart Com suporte no KMDF e a partir do UMDF versão 2.15. Se os drivers do dispositivo não estiverem suportando 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, caso tenha sido descarregado. Se várias tentativas de reinicialização consecutivas falharem (porque o driver reiniciado relatará novamente um erro), a estrutura interromperá a tentativa de reiniciar o dispositivo.
WdfDeviceFailedNoRestart Se os drivers do dispositivo não estiverem suportando outros dispositivos no sistema, o gerente de E/S descarregará os drivers.

Observações

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

Normalmente, os drivers especificam WdfDeviceFailedAttemptRestart se encontrarem um erro de software irrecuperável, porque 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 as Observações 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)

Consulte também

WdfDeviceSetFailed