PMI_EVENT-Struktur (pmi.h)

Artikel
08/07/2023

Die PMI_EVENT-Struktur enthält Informationen zu einem Leistungsmessungs- und Budgetierungsereignis, das über die Power Meter Interface (PMI) signalisiert wird.

Syntax

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

Member

Version

Ein -Wert, der die Version dieser Struktur angibt. Für Windows 7, Windows Server 2008 R2 und höhere Versionen von Windows muss dieser Wert 1 sein.

EventType

Ein PMI_EVENT_TYPE Enumerationswert, der den PMI-Ereignistyp angibt.

Hinweise

Die PMI_EVENT-Struktur enthält Informationen zu einem Leistungsmessungs- oder Budgetierungsereignis. PMI generiert ein Ereignis für einen Stromzähler, wenn eines der folgenden Ereignisse auftritt:

Die Leistungsmessungs- oder Budgetierungsfunktionen des Stromzählers haben sich geändert.
Die Konfigurationen der Leistungsmessung oder Budgetierung des Stromzählers wurden geändert.
Die vom Stromzähler überwachte Stromversorgung hat den konfigurierten Leistungsschwellenwert des Verbrauchsgeräts überschritten.
Die vom Stromzähler überwachte Stromversorgung hat das konfigurierte Strombudget der Verbrauchseinheit überschritten oder unterschritten.

Ein Benutzermodusdienst oder eine Anwendung registriert sich für die Benachrichtigung über diese Ereignisse über eine Abfrageanforderung des IOCTL_PMI_REGISTER_EVENT_NOTIFY E/A-Steuerelements (IOCTL).

Die PMI_EVENT-Struktur enthält nicht die aktuellen PMI-Daten für das Ereignis. Abhängig vom Wert des EventType-Elements kann der Aufrufer die aktuellen PMI-Daten über eine PMI-IOCTL-Abfrageanforderung abrufen. In der folgenden Tabelle wird die PMI-IOCTL beschrieben, die verwendet werden soll, um die geänderten Daten von einem Stromzähler für eine Abfrageanforderung abzufragen.

EventType-Wert	PMI IOCTL	E/A-Anforderungspaket (IRP)
PmiCapabilitiesChangedEvent	IOCTL_PMI_GET_CAPABILITIES	Der AssociatedIrp.SystemBuffer-Member wird auf die Adresse eines vom Initiator zugewiesenen Puffers festgelegt, der einen beliebigen PMI_CAPABILITIES_TYPE Enumerationswert enthält.
PmiConfigurationChangedEvent	IOCTL_PMI_GET_CONFIGURATION	Der AssociatedIrp.SystemBuffer-Member wird auf die Adresse eines vom Initiator zugewiesenen Puffers festgelegt, der einen beliebigen PMI_CONFIGURATION_TYPE Enumerationswert enthält.
PmiThresholdEvent	IOCTL_PMI_GET_CONFIGURATION	Der AssociatedIrp.SystemBuffer-Member wird auf die Adresse eines vom Initiator zugewiesenen Puffers festgelegt, der den PMI_CONFIGURATION_TYPE Enumerationswert oder PmiThresholdConfiguration enthält.
PmiBudgetEvent	IOCTL_PMI_GET_CONFIGURATION	Der AssociatedIrp.SystemBuffer-Member wird auf die Adresse eines vom Initiator zugewiesenen Puffers festgelegt, der den PMI_CONFIGURATION_TYPE-Enumerationswert oder PmiBudgetConfiguration enthält.
PmiAveragingIntervalChangedEvent	IOCTL_PMI_GET_CONFIGURATION	Der AssociatedIrp.SystemBuffer-Member wird auf die Adresse eines vom Initiator zugewiesenen Puffers festgelegt, der den PMI_CONFIGURATION_TYPE Enumerationswert oder PmiMeasurementConfiguration enthält.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 7, Windows Server 2008 R2 und höheren Versionen der Windows-Betriebssysteme.
Kopfzeile	pmi.h (pmi.h einschließen)