PMI_CONFIGURATION Struktur (pmi.h)
Die PMI_CONFIGURATION-Struktur enthält Informationen zur aktuellen Leistungsmessungs- und Budgetierungskonfiguration eines Stromzählers.
Syntax
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;
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.
Size
Ein Wert in Byteseinheiten, der die Größe der Struktur angibt.
ConfigurationType
Ein PMI_CONFIGURATION_TYPE Enumerationswert, der den Datentyp des Configuration-Members angibt.
Configuration
Eine Union der unterstützten PMI-Konfigurationsstrukturen (Power Meter Interface). Basierend auf dem Wert des ConfigurationType-Members wird eines der folgenden Configuration-Untergruppen verwendet, um auf die folgenden PMI-Konfigurationsstrukturen zu verweisen:
Configuration.MeasurementConfiguration
Eine PMI_BUDGETING_CONFIGURATION Struktur, die Informationen zur Budgetierungskonfiguration des Leistungsmessgeräts enthält.
Das Configuration-Member enthält diese Struktur, wenn das ConfigurationType-Element auf PmiBudgetingConfiguration festgelegt ist.
Configuration.BudgetingConfiguration
Eine PMI_MEASUREMENT_CONFIGURATION-Struktur , die Informationen zur Messkonfiguration des Leistungsmessgeräts enthält.
Das Configuration-Member enthält diese Struktur, wenn das ConfigurationType-Element auf PmiMeasurementConfiguration festgelegt ist.
Configuration.ThresholdConfiguration
Eine PMI_THRESHOLD_CONFIGURATION-Struktur , die Informationen zur Schwellenwertkonfiguration des Leistungsmessgeräts enthält.
Das Configuration-Member enthält diese Struktur, wenn das ConfigurationType-Element auf PmiThresoldConfiguration festgelegt ist.
Hinweise
Die PMI_CONFIGURATION-Struktur wird verwendet, um viele verschiedene PMI-Konfigurationseinstellungen abzufragen, die von einem Power Meter unterstützt werden.
Die PMI-Konfigurationsinformationen werden über eine IOCTL_PMI_GET_CONFIGURATION IOCTL-Abfrageanforderung (IOCTL) zurückgegeben. Die Eingabedaten dieser Abfrageanforderung sind auf einen PMI_CONFIGURATION_TYPE Enumeratorwert festgelegt, der den Typ der zurückzugebenden PMI-Konfigurationsdaten angibt.
Wenn die IOCTL-Abfrageanforderung erfolgreich abgeschlossen wurde, gibt die Anforderung eine PMI_CONFIGURATION Struktur zurück. Das Konfigurationselement dieser Struktur enthält Daten, die als angeforderte PMI-Konfigurationsstruktur formatiert sind.
Wenn beispielsweise eine IOCTL-Abfrageanforderung von IOCTL_PMI_GET_CONFIGURATION mit dem Eingabedatensatz an PmiBudgetingConfiguration gestellt wird und die Anforderung erfolgreich abgeschlossen wird, gibt die Anforderung eine PMI_CONFIGURATION-Struktur zurück, deren Member auf die folgenden Werte festgelegt sind:
- Das ConfigurationType-Element ist auf PmiBudgetingConfiguration festgelegt.
- Das Configuration-Element enthält Daten, die als PMI_BUDGETING_CONFIGURATION-Struktur formatiert sind.
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 (include Pmi.h) |