fonction de rappel EVT_WDF_IO_QUEUE_IO_WRITE (wdfio.h)
[S’applique à KMDF et UMDF]
La fonction de rappel d’événements EvtIoWrite pilote traite une demande d’écriture spécifiée.
Syntaxe
EVT_WDF_IO_QUEUE_IO_WRITE EvtWdfIoQueueIoWrite;
void EvtWdfIoQueueIoWrite(
[in] WDFQUEUE Queue,
[in] WDFREQUEST Request,
[in] size_t Length
)
{...}
Paramètres
[in] Queue
Handle de l’objet de file d’attente framework associé à la requête d’E/S.
[in] Request
Handle vers un objet de requête de framework.
[in] Length
Nombre d’octets à écrire.
Valeur de retour
Aucun
Remarques
Un pilote inscrit une fonction de rappel EvtIoWrite lorsqu’elle appelle WdfIoQueueCreate. Pour plus d’informations sur l’appel WdfIoQueueCreate, consultez Création de files d’attente d’E/S.
Si un pilote a inscrit une EvtIoWrite fonction de rappel pour la file d’attente d’E/S d’un appareil, la fonction de rappel reçoit chaque demande d’écriture de la file d’attente. Pour plus d’informations, consultez gestionnaires de demandes.
La fonction de rappel EvtIoWrite doit traiter chaque demande d’E/S reçue d’une certaine manière. Pour plus d’informations, consultez Traitement des requêtes d’E/S.
Les demandes d’écriture nécessitent une mémoire tampon d’entrée, qui contient les données reçues par le pilote. Pour plus d’informations sur la façon dont le pilote peut accéder à la mémoire tampon d’une demande d’écriture, consultez Accès aux mémoires tampons de données dans Framework-Based Pilotes.
Cette fonction de rappel peut être appelée au <IRQL = DISPATCH_LEVEL, sauf si le membre ExecutionLevel de l’appareil ou de la structure WDF_OBJECT_ATTRIBUTES du pilote est défini sur WdfExecutionLevelPassive.
Si le runtime d’intégration est PASSIVE_LEVEL, l’infrastructure appelle la fonction de rappel dans une région critique .
Pour plus d’informations sur les niveaux IRQL pour les gestionnaires de requêtes, consultez Using Automatic Synchronization.
La fonction de rappel EvtIoWrite d’un pilote ne doit pas appeler les méthodes d’objet file d’attente suivantes :
Spécifications
| Besoin | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.0 |
| version minimale de UMDF | 2.0 |
| En-tête | wdfio.h (include Wdf.h) |
| IRQL | <= DISPATCH_LEVEL (voir la section Remarques) |