Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
[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 OnRead est appelée pour gérer une demande de lecture lorsqu’une application lit les informations d’un appareil via la fonction ReadFile Microsoft Win32 ou ReadFileEx.
Syntaxe
void OnRead(
[in] IWDFIoQueue *pWdfQueue,
[in] IWDFIoRequest *pWdfRequest,
[in] SIZE_T NumOfBytesToRead
);
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] NumOfBytesToRead
Taille, en octets, de la mémoire tampon de lecture de la requête.
Valeur de retour
Aucun
Remarques
Un pilote inscrit l’interface IQueueCallbackRead 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 OnRead pour toutes les files d’attente d’E/S ou des méthodes OnRead distinctes pour chaque file d’attente d’E/S.
La méthode OnRead reçoit chaque type de demande de lecture de la file d’attente. (Le type de demande de lecture est identifié par la valeur WdfRequestRead du type d’énumération WDF_REQUEST_TYPE pour la requête.) La méthode OnRead doit traiter chaque demande de lecture 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 ::GetReadParameters et IWDFIoRequest ::GetOutputMemory pour récupérer des informations sur la requête et la mémoire tampon de lecture.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Windows |
| d’en-tête | wudfddi.h (include Wudfddi.h) |