structure PMI_EVENT (pmi.h)

Article
08/07/2023

La structure PMI_EVENT contient des informations sur un événement de contrôle et de budgétisation de puissance signalé par l’intermédiaire de l’interface de compteur de puissance (PMI).

Syntaxe

typedef struct _PMI_EVENT {
  ULONG          Version;
  PMI_EVENT_TYPE EventType;
} PMI_EVENT, *PPMI_EVENT;

Membres

Version

Valeur qui spécifie la version de cette structure. Pour Windows 7, Windows Server 2008 R2 et versions ultérieures de Windows, cette valeur doit être 1.

EventType

Valeur d’énumération PMI_EVENT_TYPE qui spécifie le type d’événement PMI.

Remarques

La structure PMI_EVENT contient des informations sur un événement de contrôle de puissance ou de budgétisation. L’indicateur d’alimentation génère un événement pour un compteur de puissance lorsque l’un des événements suivants se produit :

Les fonctionnalités de mesure de puissance ou de budgétisation du compteur de puissance ont changé.
Les configurations de mesure de puissance ou de budget du compteur d’énergie ont changé.
L’alimentation surveillée par le compteur d’alimentation a dépassé le seuil d’alimentation configuré du compteur.
Le bloc d’alimentation surveillé par le compteur d’alimentation a dépassé ou est tombé en dessous du budget d’alimentation configuré du compteur.

Un service ou une application en mode utilisateur s’inscrit pour la notification de ces événements par le biais d’une requête de contrôle d’E /S IOCTL_PMI_REGISTER_EVENT_NOTIFY (IOCTL).

La structure PMI_EVENT ne contient pas les données PMI actuelles pour l’événement. Selon la valeur du membre EventType , l’appelant peut récupérer les données PMI actuelles par le biais d’une demande de requête IOCTL DE LM. Le tableau suivant décrit l’IOCTL DE LAM à utiliser pour interroger les données modifiées à partir d’un compteur de puissance pour une demande de requête.

Valeur EventType	IOCTL DE L’IGP	Paquet de requête d’E/S (IRP)
PmiCapabilitiesChangedEvent	IOCTL_PMI_GET_CAPABILITIES	Le membre AssociatedIrp.SystemBuffer est défini sur l’adresse d’une mémoire tampon allouée par l’initiateur qui contient n’importe quelle valeur d’énumération PMI_CAPABILITIES_TYPE .
PmiConfigurationChangedEvent	IOCTL_PMI_GET_CONFIGURATION	Le membre AssociatedIrp.SystemBuffer est défini sur l’adresse d’une mémoire tampon allouée par l’initiateur qui contient n’importe quelle valeur d’énumération PMI_CONFIGURATION_TYPE .
PmiThresholdEvent	IOCTL_PMI_GET_CONFIGURATION	Le membre AssociatedIrp.SystemBuffer est défini sur l’adresse d’une mémoire tampon allouée par l’initiateur qui contient la valeur d’énumération PMI_CONFIGURATION_TYPE ou PmiThresholdConfiguration.
PmiBudgetEvent	IOCTL_PMI_GET_CONFIGURATION	Le membre AssociatedIrp.SystemBuffer est défini sur l’adresse d’une mémoire tampon allouée par l’initiateur qui contient la valeur d’énumération PMI_CONFIGURATION_TYPE ou PmiBudgetConfiguration.
PmiAveragingIntervalChangedEvent	IOCTL_PMI_GET_CONFIGURATION	Le membre AssociatedIrp.SystemBuffer est défini sur l’adresse d’une mémoire tampon allouée par l’initiateur qui contient la valeur d’énumération PMI_CONFIGURATION_TYPE ou PmiMeasurementConfiguration.

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)