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)

Voir aussi

EvtDeviceSelfManagedIoCleanup

EvtDeviceSelfManagedIoFlush

EvtDeviceSelfManagedIoInit

EvtDeviceSelfManagedIoSuspend