EVT_WDF_DEVICE_SELF_MANAGED_IO_RESTART fonction de rappel (wdfdevice.h)

[S’applique à KMDF et UMDF]

La fonction de rappel d’événement EvtDeviceSelfManagedIoRestart d’un pilote redémarre les opérations d’E/S auto-gé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) a la valeur 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 à 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 Reporting Device Failures.

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 retourne d’un état de faible puissance à son état de travail (D0). L’infrastructure appelle la fonction de rappel EvtDeviceSelfManagedIoRestart uniquement après avoir appelé la fonction de rappel EvtDeviceSelfManagedIoSuspendIoSuspend du pilote.

La fonction de rappel EvtDeviceSelfManagedIoRestart du pilote doit faire ce qui est nécessaire pour reprendre les opérations d’E/S auto-gé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 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 modifiable.

Configuration requise

   
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)

Voir aussi

EvtDeviceSelfManagedIoCleanup

EvtDeviceSelfManagedIoFlush

EvtDeviceSelfManagedIoInit

EvtDeviceSelfManagedIoSuspend