IWDFIoTarget ::FormatRequestForRead, 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 FormatRequestForRead met en forme un objet de requête 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 de 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 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 de l’appareil utilisé pour la lecture. Ce paramètre est facultatif.
Valeur de retour
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.
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 |