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 |