structure PMI_REPORTED_CAPABILITIES (pmi.h)

Article
02/07/2025

La structure PMI_REPORTED_CAPABILITIES contient des informations sur le type de compteur d’alimentation et les fonctionnalités de budget prises en charge par un compteur d’alimentation. En outre, cette structure contient des informations sur les ressources relatives au compteur d’alimentation lui-même.

Syntaxe

typedef struct _PMI_REPORTED_CAPABILITIES {
  ULONG                Flags;
  PMI_MEASUREMENT_UNIT MeasurementUnit;
  PMI_MEASUREMENT_TYPE MeasurementType;
  ULONG                Accuracy;
  ULONG                SamplingPeriod;
  ULONG                MinimumAverageInterval;
  ULONG                MaximumAverageInterval;
  ULONG                Hysteresis;
  BOOLEAN              Writeable;
  ULONG                MinBudget;
  ULONG                MaxBudget;
  WCHAR                ModelNumber[PMI_NAME_MAX];
  WCHAR                SerialNumber[PMI_NAME_MAX];
  WCHAR                OEMInformation[PMI_NAME_MAX];
} PMI_REPORTED_CAPABILITIES, *PPMI_REPORTED_CAPABILITIES;

Membres

Flags

Masque de bits qui spécifie les fonctionnalités prises en charge du compteur d’alimentation. Les indicateurs suivants définissent la plage de valeurs pour ce membre :

PMI_CAPABILITIES_SUPPORT_MEASUREMENT

Ce bit est défini si le compteur d’alimentation prend en charge la mesure de l’alimentation.

PMI_CAPABILITIES_SUPPORT_THRESHOLDS

Ce bit est défini si le compteur d’alimentation prend en charge les seuils d’alimentation.

PMI_CAPABILITIES_SUPPORT_BUDGETING

Ce bit est défini si le compteur d’alimentation prend en charge le budget de l’alimentation.

PMI_CAPABILITIES_DISCHARGE_ONLY

Ce bit est défini si le compteur d’alimentation signale les données uniquement lorsque l’alimentation est déchargée. Il s’agit généralement du cas sur les systèmes de batterie mobile ou sur certaines alimentations électriques non réinterruptibles (UPS).

MeasurementUnit

Valeur d’énumération PMI_MEASUREMENT_UNIT qui spécifie l’unité de mesure.

Remarque À compter de Windows 7, Windows Server 2008 R2, seules les unités de mesure de milliwatts (mW) sont prises en charge.

MeasurementType

Valeur d’énumération PMI_MEASUREMENT_TYPE qui spécifie le type de mesure, par exemple si la puissance d’entrée ou de sortie est mesurée.

Accuracy

Valeur, en unités de millièmes d’un pourcentage, qui spécifie la précision signalée du compteur d’alimentation. Par exemple, une valeur de 1 000 correspond à une évaluation de précision d’un pourcentage.

SamplingPeriod

Valeur, en unités de millisecondes, qui spécifie la période moyenne actuelle.

MinimumAverageInterval

Valeur, en unités de millisecondes, qui spécifie l’intervalle minimal de moyenne.

MaximumAverageInterval

Valeur, en unités de millisecondes, qui spécifie l’intervalle maximal de moyenne.

Hysteresis

Valeur, en unités de millisecondes, qui spécifie la valeur d’astérisie. Cette valeur indique la marge générée autour du seuil et des événements de budget. Cette valeur empêche le déclencheur d’événements inutiles lorsque la lecture varie très près de l’un des seuils.

Writeable

Valeur booléenne qui indique si les informations de budget sont en lecture/écriture (TRUE) ou en lecture seule (FALSE).

MinBudget

Valeur, en unités de watts, qui spécifie le budget minimal d’alimentation pris en charge.

MaxBudget

Valeur, en unités de watts, qui spécifie le budget maximal de puissance pris en charge.

ModelNumber[PMI_NAME_MAX]

Chaîne Unicode terminée par null qui contient le numéro de modèle du compteur d’alimentation.

SerialNumber[PMI_NAME_MAX]

Chaîne Unicode terminée par null qui contient le numéro de série du compteur d’alimentation.

OEMInformation[PMI_NAME_MAX]

Chaîne Unicode terminée par null qui contient des informations descriptives sur le compteur d’alimentation. Ces informations sont spécifiques à l’implémentation par l’OEM d’origine.

Remarques

La structure PMI_REPORTED_CAPABILITIES contient les informations suivantes sur un compteur d’alimentation :

Fonctionnalités de mesure du compteur d’alimentation.
Les fonctionnalités budgétaires du compteur d’alimentation, qui incluent si la configuration budgétaire peut être modifiée.
Informations sur la ressource du compteur d’alimentation. Ces informations sont définies par l’OEM pour le compteur d’alimentation.

La structure PMI_REPORTED_CAPABILITIES est retournée par le biais d’une requête de requête de contrôle d’E/S (IOCTL) IOCTL_PMI_GET_CAPABILITIES. Les données d’entrée de cette requête sont définies sur la valeur d’énumérateur PMI_CAPABILITIES_TYPE de ..

Si la requête de requête se termine correctement, la requête retourne une structure PMI_CAPABILITIES. Les fonctionnalités membre de cette structure sont mises en forme sous forme de structure PMI_REPORTED_CAPABILITIES.

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)