IWDFIoRequest ::GetInputMemory, 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 GetInputMemory récupère l’objet mémoire qui représente la mémoire tampon d’entrée dans une requête d’E/S.
Syntaxe
void GetInputMemory(
[out] IWDFMemory **ppWdfMemory
);
Paramètres
[out] ppWdfMemory
Pointeur vers une variable qui reçoit un pointeur vers l’interface de référence IWDFMemory pour l’objet mémoire. Notez que le retour NULL est valide ; dans ce cas, aucune mémoire d’entrée n’est associée à la requête d’E/S.
Valeur de retour
Aucun
Remarques
Les pilotes qui utilisent la méthode d’accès mise en mémoire tampon peuvent appeler GetInputMemory pour obtenir la mémoire tampon d’entrée d’une requête d’E/S.
Avant de terminer une requête d’E/S, le pilote doit appeler la méthode IWDFMemory ::Release pour l’objet mémoire. L’objet mémoire sous-jacent est libéré lorsque la requête est terminée.
La mémoire tampon d’entrée associée à la demande d’E/S contient des informations (par exemple, des données à écrire sur un disque) que l’originateur de la demande fournie. Le pilote peut appeler GetInputMemory pour obtenir la mémoire tampon d’entrée pour une demande d’écriture ou une demande de contrôle d’E/S d’appareil, mais pas pour une demande de lecture (car les demandes de lecture ne fournissent pas de données d’entrée). Pour accéder à la mémoire tampon d’entrée, le pilote doit appeler la méthode IWDFMemory ::GetDataBuffer.
UMDF crée les objets mémoire d’une requête d’E/S lorsqu’elle reçoit la requête d’E/S, avant d’ajouter la requête d’E/S à la file d’attente d’E/S d’un pilote. Si UMDF ne peut pas allouer de mémoire pour les objets mémoire, elle termine la demande d’E/S avec un état de retour d’échec et ne remet pas la demande d’E/S au pilote.
Pour plus d’informations sur l’accès aux mémoires tampons de données d’une requête d’E/S, consultez Accès aux mémoires tampons de données dans UMDF-Based Pilotes.
Exemples
Pour obtenir un exemple de code montrant comment utiliser la méthode GetInputMemory, consultez IWDFIoRequest ::Complete.
Exigences
| Exigence | Valeur |
|---|---|
| fin du support | Indisponible dans UMDF 2.0 et versions ultérieures. |
| plateforme cible | Bureau |
| version minimale de UMDF | 1.5 |
| d’en-tête | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |