Méthode IWDFIoRequest ::GetDeviceIoControlParameters (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 GetDeviceIoControlParameters récupère les paramètres de requête pour une demande de type de contrôle d’E/S d’appareil.

Syntaxe

void GetDeviceIoControlParameters(
  [out] ULONG  *pControlCode,
  [out] SIZE_T *pInBufferSize,
  [out] SIZE_T *pOutBufferSize
);

Paramètres

[out] pControlCode

Pointeur vers une variable qui reçoit le code de contrôle qui identifie l’opération spécifique à effectuer.

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

[out] pInBufferSize

Pointeur vers une variable qui reçoit la taille, en octets, de la mémoire tampon de données d’entrée pour la requête. Pour récupérer la mémoire tampon de données d’entrée, le pilote appelle la méthode IWDFIoRequest ::GetInputMemory .

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

[out] pOutBufferSize

Pointeur vers une variable qui reçoit la taille, en octets, de la mémoire tampon de données de sortie pour la requête. Pour récupérer la mémoire tampon des données de sortie, le pilote appelle la méthode IWDFIoRequest ::GetOutputMemory .

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

Valeur de retour

None

Remarques

L’appel à GetDeviceIoControlParameters échoue si le type de demande n’est pas un type de contrôle D/S d’appareil.

Bien que le pilote puisse éventuellement spécifier NULL pour chacun des paramètres pControlCode, pInBufferSize et pOutBufferSize , le pilote doit spécifier au moins un paramètre non NULL pour que GetDeviceIoControlParameters 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

IWDFIoRequest

IWDFIoRequest ::GetInputMemory

IWDFIoRequest ::GetOutputMemory