structure PMI_CONFIGURATION (pmi.h)
La structure PMI_CONFIGURATION contient des informations sur la configuration actuelle de contrôle et de budget d’un compteur de puissance.
Syntaxe
typedef struct _PMI_CONFIGURATION {
ULONG Version;
USHORT Size;
PMI_CONFIGURATION_TYPE ConfigurationType;
union {
PMI_MEASUREMENT_CONFIGURATION MeasurementConfiguration;
PMI_BUDGETING_CONFIGURATION BudgetingConfiguration;
PMI_THRESHOLD_CONFIGURATION ThresholdConfiguration;
} Configuration;
} PMI_CONFIGURATION, *PPMI_CONFIGURATION;
Membres
Version
Valeur qui spécifie la version de cette structure. Pour Windows 7, Windows Server 2008 R2 et les versions ultérieures de Windows, cette valeur doit être 1.
Size
Valeur, en unités d’octets, qui spécifie la taille de la structure.
ConfigurationType
Valeur d’énumération PMI_CONFIGURATION_TYPE qui spécifie le type de données du membre Configuration .
Configuration
Union des structures de configuration pmi (Power Meter Interface) prises en charge. En fonction de la valeur du membre ConfigurationType , l’un des sous-membres Configuration suivants est utilisé pour référencer les structures de configuration PMI suivantes :
Configuration.MeasurementConfiguration
Une structure PMI_BUDGETING_CONFIGURATION qui contient des informations sur la configuration du budget du compteur de puissance.
Le membre Configuration contient cette structure si le membre ConfigurationType est défini sur PmiBudgetingConfiguration.
Configuration.BudgetingConfiguration
Une structure PMI_MEASUREMENT_CONFIGURATION qui contient des informations sur la configuration de mesure du compteur de puissance.
Le membre Configuration contient cette structure si le membre ConfigurationType est défini sur PmiMeasurementConfiguration.
Configuration.ThresholdConfiguration
Une structure PMI_THRESHOLD_CONFIGURATION qui contient des informations sur la configuration du seuil du compteur de puissance.
Le membre Configuration contient cette structure si le membre ConfigurationType est défini sur PmiThresoldConfiguration.
Remarques
La structure PMI_CONFIGURATION est utilisée pour interroger de nombreux paramètres de configuration PMI différents pris en charge par un compteur de puissance.
Les informations de configuration PMI sont retournées par le biais d’une requête de contrôle d’E/S IOCTL_PMI_GET_CONFIGURATION (IOCTL). Les données d’entrée de cette requête sont définies sur une valeur d’énumérateur PMI_CONFIGURATION_TYPE qui spécifie le type de données de configuration PMI à retourner.
Si la requête IOCTL se termine correctement, la demande retourne une structure PMI_CONFIGURATION. Le membre Configuration de cette structure contient des données qui sont mises en forme en tant que structure de configuration PMI demandée.
Par exemple, si une requête IOCTL de IOCTL_PMI_GET_CONFIGURATION est effectuée avec le jeu de données d’entrée sur PmiBudgetingConfiguration et que la demande se termine correctement, la requête retourne une structure PMI_CONFIGURATION avec ses membres définis sur les valeurs suivantes :
- Le membre ConfigurationType est défini sur PmiBudgetingConfiguration.
- Le membre Configuration contient des données qui sont mises en forme en tant que structure PMI_BUDGETING_CONFIGURATION .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows 7, Windows Server 2008 R2 et versions ultérieures des systèmes d’exploitation Windows. |
| En-tête | pmi.h (inclure Pmi.h) |