IWDFIoRequest ::GetDeviceIoControlParameters, 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 Bien démarrer avec UMDF.]
La méthode GetDeviceIoControlParameters récupère les paramètres de requête d’une requête 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 NULL si le pilote ne nécessite pas les 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 NULL si le pilote ne nécessite pas les informations.
[out] pOutBufferSize
Pointeur vers une variable qui reçoit la taille, en octets, de la mémoire tampon de données de sortie de la requête. Pour récupérer la mémoire tampon de données de sortie, le pilote appelle la méthode IWDFIoRequest ::GetOutputMemory.
Ce paramètre est facultatif. Le pilote peut passer NULL si le pilote ne nécessite pas les informations.
Valeur de retour
Aucun
Remarques
L’appel à GetDeviceIoControlParameters échoue si le type de requête n’est pas un type de contrôle d’E/S d’appareil.
Bien que le pilote puisse éventuellement spécifier NULL pour chacun des pControlCode, pInBufferSizeet paramètres pOutBufferSize, le pilote doit spécifier au moins un paramètre nullnon- pour GetDeviceIoControlParameters pour qu’il s’exécute correctement.
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 |