Méthode IWDFIoTarget ::FormatRequestForWrite (wudfddi.h)

Article
03/01/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 FormatRequestForWrite met en forme un objet de demande d’E/S pour une opération d’écriture.

Syntaxe

HRESULT FormatRequestForWrite(
  [in]           IWDFIoRequest     *pRequest,
  [in, optional] IWDFFile          *pFile,
  [in, optional] IWDFMemory        *pInputMemory,
  [in, optional] PWDFMEMORY_OFFSET pInputMemoryOffset,
  [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 d’écriture. Pour la cible d’E/S par défaut, ce paramètre doit être non NULL.

[in, optional] pInputMemory

Pointeur vers l’interface IWDFMemory utilisée pour accéder à la mémoire tampon utilisée pour la demande d’écriture. Ce paramètre est facultatif.

[in, optional] pInputMemoryOffset

Pointeur vers une structure de WDFMEMORY_OFFSET qui décrit le décalage de mémoire d’entrée utilisé pour la demande d’écriture. Ce paramètre est facultatif.

[in, optional] DeviceOffset

Pointeur vers le décalage d’appareil utilisé pour la demande d’écriture. Ce paramètre est facultatif.

Valeur renvoyée

FormatRequestForWrite 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

Voir aussi