IQueueCallbackWrite ::OnWrite, méthode (wudfddi.h)
[Avertissement : UMDF 2 est la dernière version de UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide de UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et il existe une prise en charge limitée de UMDF 1 sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Bien démarrer avec UMDF.]
La méthode OnWrite est appelée pour gérer une demande d’écriture lorsqu’une application écrit des informations sur un appareil via la fonction WriteFile Microsoft Win32 ou WriteFileEx.
Syntaxe
void OnWrite(
[in] IWDFIoQueue *pWdfQueue,
[in] IWDFIoRequest *pWdfRequest,
[in] SIZE_T NumOfBytesToWrite
);
Paramètres
[in] pWdfQueue
Pointeur vers l’interface IWDFIoQueue pour l’objet de file d’attente d’E/S à partir duquel la requête arrive.
[in] pWdfRequest
Pointeur vers l’interface IWDFIoRequest qui représente l’objet de requête de framework.
[in] NumOfBytesToWrite
Taille, en octets, de la mémoire tampon d’écriture pour la requête.
Valeur de retour
Aucun
Remarques
Un pilote inscrit l’interface IQueueCallbackWrite lorsque le pilote appelle la méthode IWDFDevice ::CreateIoQueue pour créer une file d’attente d’E/S ou configurer la file d’attente d’E/S par défaut.
Un pilote peut implémenter une seule méthode OnWrite pour toutes les files d’attente d’E/S ou séparer méthodes d' onWrite pour chaque file d’attente d’E/S.
La méthode OnWrite reçoit chaque type de demande d’écriture de la file d’attente. (Le type de demande d’écriture est identifié par la valeur WdfRequestWrite du type d’énumération WDF_REQUEST_TYPE pour la requête.) La méthode OnWrite doit traiter chaque demande d’écriture reçue. Pour plus d’informations sur la façon dont les pilotes UMDF traitent les requêtes d’E/S, consultez Traitement des requêtes d’E/S.
Le pilote peut appeler les méthodes IWDFIoRequest ::GetWriteParameters et IWDFIoRequest ::GetInputMemory pour récupérer des informations sur la requête et la mémoire tampon d’écriture.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Windows |
| d’en-tête | wudfddi.h (include Wudfddi.h) |