Partager via

Méthode IWDFIoRequest ::GetReadParameters (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 GetReadParameters récupère les paramètres de requête pour une requête de type lecture.

Syntaxe

void GetReadParameters(
  [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, à lire. Pour récupérer les données de lecture, le pilote appelle la méthode IWDFIoRequest ::GetOutputMemory .

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 la lecture à partir de l’appareil ou du fichier sur l’appareil. Si l’appareil ne prend pas en charge les adresses de lecture 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 Microsoft Win32 ReadFile ou ReadFileEx .

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 à GetReadParameters échoue si le type de requête n’est pas un type lecture.

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.

Bien que le pilote puisse éventuellement spécifier NULL pour chacun des paramètres pSizeInBytes, pullOffset et pulKey , le pilote doit spécifier au moins un paramètre non NULL pour que GetReadParameters s’exécute correctement.

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