EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT fonction de rappel (wdfdevice.h)

  • Article

[S’applique à KMDF et UMDF]

La fonction de rappel d’événement EvtDeviceSelfManagedIoInit d’un pilote initialise et démarre les opérations d’E/S autogérées de l’appareil.

Syntaxe

EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT EvtWdfDeviceSelfManagedIoInit;

NTSTATUS EvtWdfDeviceSelfManagedIoInit(
  [in] WDFDEVICE Device
)
{...}

Paramètres

[in] Device

Handle d’un objet d’appareil framework.

Valeur retournée

Si la fonction de rappel EvtDeviceSelfManagedIoInit 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) a la valeur FALSE, l’infrastructure ne démarre pas 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 EvtDeviceSelfManagedIoInit , un pilote doit appeler WdfDeviceInitSetPnpPowerEventCallbacks.

Si le pilote a inscrit une fonction de rappel EvtDeviceSelfManagedIoInit , l’infrastructure l’appelle une fois pour chaque appareil, une fois que l’infrastructure a appelé la fonction de rappel EvtDeviceD0Entry du pilote pour la première fois. L’infrastructure n’appelle pas la fonction de rappel EvtDeviceSelfManagedIoInit pour cet appareil, sauf si l’appareil est supprimé et reconnecté, ou si les pilotes sont rechargés.

La fonction de rappel EvtDeviceSelfManagedIoInit doit initialiser et démarrer les opérations d’E/S autogérées que le pilote gérera pour 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.

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 aussi

EvtDeviceSelfManagedIoCleanup

EvtDeviceSelfManagedIoFlush

EvtDeviceSelfManagedIoRestart

EvtDeviceSelfManagedIoSuspend