énumération WDF_DEVICE_FAILED_ACTION (wdfdevice.h)

[S’applique à KMDF et UMDF]

L’énumération WDF_DEVICE_FAILED_ACTION identifie l’action que l’infrastructure prendra lorsqu’un pilote signale une défaillance matérielle ou logicielle irrécupérable.

Syntaxe

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

Constantes

WdfDeviceFailedUndefined Valeur : 0 Pour une utilisation interne uniquement.
WdfDeviceFailedAttemptRestart Pris en charge dans KMDF et à partir de UMDF version 2.15. Si les pilotes de l’appareil ne prennent pas en charge d’autres appareils connectés à l’ordinateur, le gestionnaire d’E/S décharge les pilotes. Ensuite, le gestionnaire Plug-and-Play tente de redémarrer l’appareil en demandant au pilote de bus de réumer ses appareils. Si le pilote de bus prend en charge la réenumation, votre pilote est rechargé, s’il a été déchargé. Si plusieurs tentatives de redémarrage consécutives échouent (car le pilote redémarré signale une erreur), l’infrastructure cesse de tenter de redémarrer l’appareil.
WdfDeviceFailedNoRestart Si les pilotes de l’appareil ne prennent pas en charge d’autres appareils sur le système, le gestionnaire d’E/S décharge les pilotes.

Remarques

L’énumération WDF_DEVICE_FAILED_ACTION est utilisée comme argument d’entrée pour WdfDeviceSetFailed.

Les pilotes spécifient généralement WdfDeviceFailedAttemptRestart s’ils rencontrent une erreur logicielle irrécupérable, car la spécification de cet énumérateur recharge les pilotes. Un pilote peut spécifier WdfDeviceFailedNoRestart s’il rencontre une erreur matérielle irrécupérable qui affecte tous les appareils du pilote.

Pour plus d’informations sur la spécification WdfDeviceFailedAttemptRestart dans un pilote UMDF, consultez les remarques de WdfDeviceSetFailed.

Exigences

Exigence	Valeur
version minimale de KMDF	1.0
version minimale de UMDF	2.0
d’en-tête	wdfdevice.h (include Wdf.h)

Voir aussi

WdfDeviceSetFailed