Méthode IWDFIoTarget ::FormatRequestForRead (wudfddi.h)
[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 FormatRequestForRead met en forme un objet de demande d’E/S pour une opération de lecture.
Syntaxe
HRESULT FormatRequestForRead(
[in] IWDFIoRequest *pRequest,
[in, optional] IWDFFile *pFile,
[in, optional] IWDFMemory *pOutputMemory,
[in, optional] PWDFMEMORY_OFFSET pOutputMemoryOffset,
[in, optional] PLONGLONG DeviceOffset
);
Paramètres
[in] pRequest
Pointeur vers l’interface IWDFIoRequest pour que l’objet de requête soit mis en forme.
[in, optional] pFile
Pointeur vers l’interface IWDFFile pour l’objet fichier associé à la demande de lecture. Pour la cible d’E/S par défaut, ce paramètre doit être non NULL.
[in, optional] pOutputMemory
Pointeur vers l’interface IWDFMemory utilisée pour accéder à la mémoire tampon utilisée pour la demande de lecture. Ce paramètre est facultatif.
[in, optional] pOutputMemoryOffset
Pointeur vers une structure de WDFMEMORY_OFFSET qui décrit le décalage de mémoire de sortie utilisé pour la lecture. Ce paramètre est facultatif.
[in, optional] DeviceOffset
Pointeur vers le décalage d’appareil utilisé pour la lecture. Ce paramètre est facultatif.
Valeur renvoyée
FormatRequestForRead retourne S_OK si l’opération réussit. Sinon, cette méthode retourne l’un des codes d’erreur définis dans Winerror.h.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Fin de la prise en charge | Non disponible dans UMDF 2.0 et versions ultérieures. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| Version UMDF minimale | 1.5 |
| En-tête | wudfddi.h (inclure Wudfddi.h) |
| DLL | WUDFx.dll |