PMI_EVENT構造体には、電力メーター インターフェイス (PMI) を介して通知される電力使用状況測定および予算作成イベントに関する情報が含まれています。
構文
typedef struct _PMI_EVENT {
ULONG Version;
PMI_EVENT_TYPE EventType;
} PMI_EVENT, *PPMI_EVENT;
メンバーズ
Version
この構造体のバージョンを指定する値。 Windows 7、Windows Server 2008 R2、およびそれ以降のバージョンの Windows の場合、この値は 1 である必要があります。
EventType
PMI イベントの種類を指定する PMI_EVENT_TYPE 列挙値。
備考
PMI_EVENT構造体には、電力使用状況測定または予算作成イベントに関する情報が含まれています。 PMI では、次のいずれかが発生すると、電力メーターのイベントが生成されます。
- 電力メーターの電力使用状況測定または予算作成機能が変更されました。
- 電力メーターの電力使用状況測定または予算設定の構成が変更されました。
- 電源メーターによって監視される電源が、メーターの構成された電力しきい値を超えています。
- 電力メーターで監視されている電源が、メーターの構成された電力バジェットを超えたか、下回っています。
PMI_EVENT構造体には、イベントの現在の PMI データが含まれていません。 EventType メンバーの値に応じて、呼び出し元は PMI IOCTL クエリ要求を介して現在の PMI データを取得できます。 次の表では、電源メーターから変更されたデータに対してクエリ要求のクエリを実行するために使用する PMI IOCTL について説明します。
| EventType 値 | PMI IOCTL | I/O 要求パケット (IRP) |
|---|---|---|
| PmiCapabilitiesChangedEvent | AssociatedIrp.SystemBuffer メンバーは、任意の PMI_CAPABILITIES_TYPE 列挙値を含むイニシエーターによって割り当てられたバッファーのアドレスに設定されます。 | |
| PmiConfigurationChangedEvent の | AssociatedIrp.SystemBuffer メンバーは、任意の PMI_CONFIGURATION_TYPE 列挙値を含むイニシエーターによって割り当てられたバッファーのアドレスに設定されます。 | |
| PmiThresholdEvent の | AssociatedIrp.SystemBuffer メンバーは、PMI_CONFIGURATION_TYPE 列挙値または PmiThresholdConfigurationを含むイニシエーター割り当てバッファーのアドレスに設定されます。 | |
| PmiBudgetEvent の | AssociatedIrp.SystemBuffer メンバーは、PMI_CONFIGURATION_TYPE 列挙値を含むイニシエーター割り当てバッファーのアドレスまたは PmiBudgetConfiguration に設定されます。 | |
| PmiAveragingIntervalChangedEvent | AssociatedIrp.SystemBuffer メンバーは、PMI_CONFIGURATION_TYPE 列挙値または PmiMeasurementConfigurationを含むイニシエーターによって割り当てられたバッファーのアドレスに設定されます。 |
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 7、Windows Server 2008 R2、およびそれ以降のバージョンの Windows オペレーティング システムで使用できます。 |
| ヘッダー | pmi.h (Pmi.h を含む) |