Partager via

Méthode IWDFIoRequest ::GetWriteParameters (wudfddi.h)

  • Article

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 GetWriteParameters récupère les paramètres de requête pour 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 pour l’écriture, le pilote appelle la méthode IWDFIoRequest ::GetInputMemory .

Ce paramètre est facultatif. Le pilote peut passer la valeur NULL s’il n’a pas besoin des 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 Notes qui suit.

Les applications clientes spécifient cette valeur dans les membres Offset et OffsetHigh de la structure CHEVAUCHEMENT. Un pointeur vers OVERLAPPED est passé dans la fonction WriteFile ou WriteFileEx de Microsoft Win32.

Ce paramètre est facultatif. Le pilote peut passer la valeur NULL s’il n’a pas besoin des informations.

[out, optional] pulKey

Pointeur vers une variable qui reçoit une clé que le pilote peut utiliser pour trier la demande d’E/S d’une manière que le pilote détermine.

Ce paramètre est facultatif. Le pilote peut passer la valeur NULL s’il n’a pas besoin des informations.

Valeur de retour

None

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 vers laquelle pointe le paramètre pullOffset 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 dans pullOffset.

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