EVT_WDF_DEVICE_SELF_MANAGED_IO_INIT fonction de rappel (wdfdevice.h)
[S’applique à KMDF et UMDF]
La fonction de rappel d’événements EvtDeviceSelfManagedIoInit du 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 vers un objet d’appareil framework.
Valeur de retour
Si la fonction de rappel EvtDeviceSelfManagedIoInit 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(état) est égal à FALSE. Si NT_SUCCESS(état) est égal à FALSE, le framework ne démarre pas 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 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 fonction de rappel pour la première fois. L’infrastructure n’appelle pas la EvtDeviceSelfManagedIoInit fonction de rappel pour cet appareil, sauf si l’appareil est supprimé et reconnecté, ou que les pilotes sont rechargés.
La fonction de rappel EvtDeviceSelfManagedIoInit doit initialiser et démarrer les opérations d’E/S auto-gérées que le pilote gère pour 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.
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 |