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

Voir aussi

IWDFFile

IWDFIoRequest

IWDFIoTarget

IWDFMemory

WDFMEMORY_OFFSET