Partager via


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