Méthode IQueueCallbackRead ::OnRead (wudfddi.h)

Article
03/05/2024

[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.]

La méthode OnRead est appelée pour gérer une demande de lecture lorsqu’une application lit des informations à partir d’un appareil via la fonction ReadFile ou ReadFileEx de Microsoft Win32.

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 file d’attente d’E/S à partir duquel la demande arrive.

[in] pWdfRequest

Pointeur vers l’interface IWDFIoRequest qui représente l’objet de demande d’infrastructure.

[in] NumOfBytesToRead

Taille, en octets, de la mémoire tampon de lecture de la requête.

Valeur de retour

None

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 pour 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 demandes d’E/S, consultez Traitement des demandes 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.