IOCTL_PMI_GET_MEASUREMENT IOCTL (pmi.h)
La requête IOCTL_PMI_GET_MEASUREMENT retourne les données de mesure actuelles d’un compteur d’alimentation.
Code principal
Mémoire tampon d’entrée
Mémoire tampon de sortie allouée par l’initiateur pointée par l'AssociatedIrp.SystemBuffer membre de l’IRP.
Longueur de la mémoire tampon d’entrée
Le Parameters.DeviceIoControl.OutputBufferLength 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 de sortie allouée par l’initiateur pointée par l'AssociatedIrp.SystemBuffer membre de l’IRP. Cette taille doit être supérieure ou égale à taille de(PMI_MEASUREMENT_DATA) ou la demande échoue avec un état d’erreur de STATUS_BUFFER_TOO_SMALL.
Mémoire tampon de sortie
Si la requête se termine correctement, la mémoire tampon de sortie pointée par l'AssociatedIrp.SystemBuffer membre contient une structure PMI_MEASUREMENT_DATA. Cette structure contient les données de mesure demandées.
Longueur de la mémoire tampon de sortie
Taille d’une structure PMI_MEASUREMENT_DATA.
Bloc d’état
Le membre d’informations est défini sur la taille, en octets, d’une structure PMI_MEASUREMENT_DATA.
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_MEASUREMENT_DATA.
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_GET_MEASUREMENT interroge les données de mesure actuelles du compteur d’alimentation. Ces données de mesure sont échantillonnée et calculées en fonction des paramètres de configuration de mesure du compteur d’alimentation. Les paramètres de configuration de mesure sont interrogés par le biais de la demande de IOCTL_PMI_GET_CONFIGURATION avec une valeur de PMI_CONFIGURATION_TYPE d’entrée de PmiMeasurementConfiguration .
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) |