structure PMI_CAPABILITIES (pmi.h)
La structure PMI_CAPABILITIES contient des informations sur les capacités de contrôle et de budget d’un compteur de puissance.
Syntaxe
typedef struct _PMI_CAPABILITIES {
ULONG Version;
ULONG Size;
PMI_CAPABILITIES_TYPE CapabilityType;
union {
PMI_REPORTED_CAPABILITIES ReportedCapabilities;
PMI_METERED_HARDWARE_INFORMATION MeteredHardwareInformation;
} Capabilities;
} PMI_CAPABILITIES, *PPMI_CAPABILITIES;
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.
CapabilityType
Valeur d’énumération PMI_CAPABILITIES_TYPE qui spécifie le type de données du membre Capabilities .
Capabilities
Union des structures de capacité PMI (Power Meter Interface) prises en charge. En fonction de la valeur du membre CapabilityType , l’un des sous-membres Capabilities suivants est utilisé pour référencer les structures de capacité PMI suivantes :
Capabilities.ReportedCapabilities
Une structure PMI_METERED_HARDWARE_INFORMATION qui spécifie un ou plusieurs périphériques matériels surveillés par le compteur d’alimentation.
Le membre Capabilities contient cette structure si le membre CapabilityType est défini sur PmiMeteredHardware.
Capabilities.MeteredHardwareInformation
Une structure PMI_REPORTED_CAPABILITIES qui spécifie les fonctionnalités PMI du compteur de puissance, par exemple :
- Informations sur les ressources
- Fonctionnalités de mesure
- Fonctionnalités d’alimentation et de budget
Remarques
La structure PMI_CAPABILITIES est utilisée pour interroger de nombreuses fonctionnalités PMI prises en charge par un compteur de puissance.
Les informations de capacité PMI sont retournées par le biais d’une requête de contrôle d’E/S IOCTL_PMI_GET_CAPABILITIES (IOCTL). Les données d’entrée de cette requête sont définies sur une valeur d’énumérateur PMI_CAPABILITIES_TYPE qui spécifie le type de données de capacité PMI à retourner.
Si la requête IOCTL se termine correctement, la requête retourne une structure PMI_CAPABILITIES. Le membre Capabilities de cette structure contient des données mises en forme en tant que structure de fonctionnalités PMI demandées.
Par exemple, si une requête IOCTL de IOCTL_PMI_GET_CAPABILITIES est effectuée avec le jeu de données d’entrée sur PmiReportedCapabilities et que la demande se termine correctement, la demande retourne une structure PMI_CAPABILITIES dont les membres sont définis sur les valeurs suivantes :
- Le membre CapabilitiesType est défini sur PmiReportedCapabilities.
- Le membre Capabilities contient des données mises en forme en tant que structure PMI_REPORTED_CAPABILITIES .
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) |