EVT_WDF_DEVICE_SELF_MANAGED_IO_RESTART fonction de rappel (wdfdevice.h)
[S’applique à KMDF et UMDF]
Le EvtDeviceSelfManagedIoRestart d’un pilote fonction de rappel d’événement 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 vers un objet d’appareil framework.
Valeur de retour
Si la fonction de rappel EvtDeviceSelfManagedIoRestart ne rencontre aucune erreur, elle doit retourner STATUS_SUCCESS, ou une autre valeur d’état pour laquelle NT_SUCCESS(status) est égal TRUE. Sinon, il doit retourner une valeur d’état pour laquelle NT_SUCCESS(status) est égal à 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 à FAUX, 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 Reporting Device Failures.
Remarques
Pour inscrire une fonction de rappel EvtDeviceSelfManagedIoRestart, un pilote doit appeler WdfDeviceInitSetPnpPowerEventCallbacks.
Si le pilote a inscrit un EvtDeviceSelfManagedIoRestart fonction de rappel, l’infrastructure l’appelle chaque fois que l’appareil retourne un état de faible puissance à son état de fonctionnement (D0). L’infrastructure appelle la fonction de rappel EvtDeviceSelfManagedIoRestart uniquement après avoir appelé la fonction de rappel EvtDeviceSelfManagedIoSuspend fonction de rappel.
Le EvtDeviceSelfManagedIoRestart du pilote fonction de rappel doit faire 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 Power Management.
Pour plus d’informations sur les pilotes qui fournissent cette fonction de rappel, consultez Using 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.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.0 |
| version minimale de UMDF | 2.0 |
| d’en-tête | wdfdevice.h (include Wdf.h) |
| IRQL | PASSIVE_LEVEL (voir la section Remarques) |