IWDFIoRequest ::GetWriteParameters, 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 Prise en main de UMDF.
La méthode GetWriteParameters récupère les paramètres de requête d’une requête de type écriture.
Syntaxe
void GetWriteParameters(
[out, optional] SIZE_T *pSizeInBytes,
[out, optional] LONGLONG *pullOffset,
[out, optional] ULONG *pulKey
);
Paramètres
[out, optional] pSizeInBytes
Pointeur vers une variable qui reçoit la taille, en octets, à écrire. Pour récupérer les données à écrire, le pilote appelle la méthode IWDFIoRequest ::GetInputMemory.
Ce paramètre est facultatif. Le pilote peut passer NULL s’il ne nécessite pas les informations.
[out, optional] pullOffset
Pointeur vers une variable qui reçoit le décalage, en octets, pour commencer à écrire sur l’appareil ou le fichier sur l’appareil. Si l’appareil ne prend pas en charge les adresses d’écriture absolues, pullOffset peut être ignoré. Pour plus d’informations, consultez la section Remarques suivante.
Les applications clientes spécifient cette valeur dans le offset et membres de la structure OVERLAPPED. Un pointeur vers OVERLAPPED est passé dans la fonction WriteFile Microsoft Win32 ou writeFileEx.
Ce paramètre est facultatif. Le pilote peut passer NULL s’il ne nécessite pas les informations.
[out, optional] pulKey
Pointeur vers une variable qui reçoit une clé que le pilote peut utiliser pour trier la requête d’E/S d’une manière que le pilote détermine.
Ce paramètre est facultatif. Le pilote peut passer NULL s’il ne nécessite pas les informations.
Valeur de retour
Aucun
Remarques
Un appel à GetWriteParameters échoue si le type de requête n’est pas un type d’écriture.
Pour les appareils qui prennent en charge l’adressage (par exemple, un périphérique de disque), la valeur que le pullOffset points de paramètre est généralement le décalage d’octet dans l’appareil. Pour les appareils qui ne prennent pas en charge l’adressage (par exemple, un port série), le pilote peut ignorer la valeur à pullOffset.
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
- IWDFIoRequest
- IWDFIoRequest ::GetInputMemory