Méthode IWDFIoTarget ::FormatRequestForIoctl (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 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 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é 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 de 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é 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 de WDFMEMORY_OFFSET qui décrit le décalage de mémoire de sortie pour la requête. Ce paramètre est facultatif.
Valeur renvoyée
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.
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour