IWDFIoTarget ::FormatRequestForIoctl, méthode (wudfddi.h)

Article
02/07/2025

[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 FormatRequestForIoctl met en forme un objet de requête d’E/S pour une opération de contrôle d’E/S.

Syntaxe

HRESULT FormatRequestForIoctl(
  [in]           IWDFIoRequest     *pRequest,
  [in]           ULONG             IoctlCode,
  [in, optional] IWDFFile          *pFile,
  [in, optional] IWDFMemory        *pInputMemory,
  [in, optional] PWDFMEMORY_OFFSET pInputMemoryOffset,
  [in, optional] IWDFMemory        *pOutputMemory,
  [in, optional] PWDFMEMORY_OFFSET pOutputMemoryOffset
);

Paramètres

[in] pRequest

Pointeur vers l’interface IWDFIoRequest pour que l’objet de requête soit mis en forme.

[in] IoctlCode

Code de contrôle qui identifie une opération spécifique à effectuer.

[in, optional] pFile

Pointeur vers l’interface IWDFFile pour l’objet de fichier associé à la demande de contrôle d’E/S. 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 d’entrée de la requête. Ce paramètre est facultatif.

[in, optional] pInputMemoryOffset

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

[in, optional] pOutputMemory

Pointeur vers l’interface IWDFMemory utilisée pour accéder à la mémoire tampon de sortie de la requête. 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 de la requête. Ce paramètre est facultatif.

Valeur de retour

FormatRequestForIoctl 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

Voir aussi

IWDFFile

IWDFIoRequest

IWDFIoTarget

IWDFMemory

WDFMEMORY_OFFSET

Partager via