EVT_WDF_DEVICE_SELF_MANAGED_IO_RESTART fonction de rappel (wdfdevice.h)
[S’applique à KMDF et UMDF]
La fonction de rappel de l’événement EvtDeviceSelfManagedIoRestart d’un pilote redémarre les opérations d’E/S autogérées d’un appareil.
Syntaxe
EVT_WDF_DEVICE_SELF_MANAGED_IO_RESTART EvtWdfDeviceSelfManagedIoRestart;
NTSTATUS EvtWdfDeviceSelfManagedIoRestart(
[in] WDFDEVICE Device
)
{...}
Paramètres
[in] Device
Handle d’un objet d’appareil framework.
Valeur retournée
Si la fonction de rappel EvtDeviceSelfManagedIoRestart ne rencontre aucune erreur, elle doit retourner STATUS_SUCCESS ou une autre valeur status pour laquelle NT_SUCCESS(status) est égal à TRUE. Sinon, il doit retourner une valeur status pour laquelle NT_SUCCESS(status) est false. Si NT_SUCCESS(status) est égal àFALSE, l’infrastructure arrête l’appareil et décharge les pilotes de l’appareil.
Si NT_SUCCESS(status) est égal à FALSE, l’infrastructure appelle les fonctions de rappel EvtDeviceSelfManagedIoFlush et EvtDeviceSelfManagedIoCleanup du pilote.
Pour plus d’informations sur les valeurs de retour de cette fonction de rappel, consultez Signalement des échecs d’appareil.
Remarques
Pour inscrire une fonction de rappel EvtDeviceSelfManagedIoRestart , un pilote doit appeler WdfDeviceInitSetPnpPowerEventCallbacks.
Si le pilote a inscrit une fonction de rappel EvtDeviceSelfManagedIoRestart , l’infrastructure l’appelle chaque fois que l’appareil revient d’un état de faible consommation à son état de travail (D0). L’infrastructure appelle la fonction de rappel EvtDeviceSelfManagedIoRestart uniquement après avoir appelé la fonction de rappel EvtDeviceSelfManagedIoSuspend du pilote.
La fonction de rappel EvtDeviceSelfManagedIoRestart du pilote doit faire tout ce qui est nécessaire pour reprendre les opérations d’E/S autogérées de l’appareil.
Pour plus d’informations sur le moment où l’infrastructure appelle cette fonction de rappel, consultez Scénarios pnP et de gestion de l’alimentation.
Pour plus d’informations sur les pilotes qui fournissent cette fonction de rappel, consultez Utilisation de Self-Managed E/S.
La fonction de rappel EvtDeviceSelfManagedIoRestart est appelée à IRQL = PASSIVE_LEVEL. Vous ne devez pas rendre cette fonction de rappel paginable.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| Version UMDF minimale | 2.0 |
| En-tête | wdfdevice.h (include Wdf.h) |
| IRQL | PASSIVE_LEVEL (voir la section Remarques) |