Méthode IQueueCallbackWrite ::OnWrite (wudfddi.h)

Article
02/27/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 OnWrite est appelée pour gérer une demande d’écriture lorsqu’une application écrit des informations sur un appareil via la fonction Microsoft Win32 WriteFile 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 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 demande d’infrastructure.

[in] NumOfBytesToWrite

Taille, en octets, de la mémoire tampon d’écriture pour la requête.

Valeur de retour

None

Remarques

Un pilote inscrit l’interface IQueueCallbackWrite quand 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 OnWrite pour toutes les files d’attente d’E/S ou des méthodes OnWrite distinctes 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 demandes d’E/S, consultez Traitement des demandes 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.