IOCTL_PMI_SET_CONFIGURATION IOCTL (pmi.h)
La requête IOCTL_PMI_SET_CONFIGURATION définit les données de configuration d’un compteur d’alimentation.
Code principal
Mémoire tampon d’entrée
Le AssociatedIrp.SystemBuffer membre du paquet de requête d’E/S pointe vers une mémoire tampon d’entrée allouée par l’initiateur qui contient une structure de PMI_CONFIGURATION. Cette structure contient les données de configuration.
Longueur de la mémoire tampon d’entrée
Le Parameters.DeviceIoControl.InputBufferLength membre de l’emplacement actuel de la pile d’E/S IRP (IO_STACK_LOCATION) est défini sur la taille en octets de la mémoire tampon d’entrée pointée par le membre AssociatedIrp.SystemBuffer membre. Cette taille doit être supérieure ou égale à taille de(PMI_CONFIGURATION) ou la requête échoue avec un état d’erreur de STATUS_BUFFER_TOO_SMALL.
Mémoire tampon de sortie
Aucun.
Longueur de la mémoire tampon de sortie
Aucun.
Bloc d’état
Le membre Information est défini sur la taille, en octets, d’une structure PMI_CONFIGURATION.
Le membre Status est défini sur l’une des valeurs suivantes :
STATUS_BUFFER_TOO_SMALL
Le membre Parameters.DeviceIoControl.OutputBufferLength du IRP est inférieur à la taille, en octets, d’une structure PMI_CONFIGURATION.
STATUS_SUCCESS
Le pilote WDM qui prend en charge l’interface PMI a terminé la demande IOCTL avec succès.
Remarques
La requête IOCTL_PMI_SET_CONFIGURATION définit les paramètres de configuration du compteur d’alimentation. L'AssociatedIrp.SystemBuffer membre de l’IRP fait référence à une mémoire tampon qui contient une structure PMI_CONFIGURATION. Le ConfigurationType membre de cette structure contient des informations sur le type de données de configuration PMI à définir dans le compteur d’alimentation.
Seules les données de configuration PMI que le compteur d’alimentation prend en charge avec les autorisations de lecture/écriture peuvent être modifiées à l’aide d’une demande définie de IOCTL_PMI_SET_CONFIGURATION. Une demande définie de IOCTL_PMI_SET_CONFIGURATION pour modifier les données de configuration PMI en lecture seule échoue et les données ne seront pas modifiées sur le compteur d’alimentation.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows 7, Windows Server 2008 R2 et versions ultérieures des systèmes d’exploitation Windows. |
| d’en-tête | pmi.h (include Pmi.h) |