Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die PMI_CONFIGURATION-Struktur enthält Informationen zur aktuellen Energiemessungs- 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;
Angehörige
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 Byteeinheiten, der die Größe der Struktur angibt.
ConfigurationType
Ein PMI_CONFIGURATION_TYPE Enumerationswert, der den Datentyp des Configuration Members angibt.
Configuration
Eine Vereinigung der unterstützten PmI-Konfigurationsstrukturen (Power Meter Interface). Basierend auf dem Wert des ConfigurationType Members wird eins der folgenden Configuration-Untermembers verwendet, um auf die folgenden PMI-Konfigurationsstrukturen zu verweisen:
Configuration.MeasurementConfiguration
Eine PMI_BUDGETING_CONFIGURATION Struktur, die Informationen zur Budgetierungskonfiguration des Stromzählers enthält.
Das Configuration-Mitglied enthält diese Struktur, wenn das ConfigurationType Member auf PmiBudgetingConfigurationfestgelegt ist.
Configuration.BudgetingConfiguration
Eine PMI_MEASUREMENT_CONFIGURATION Struktur, die Informationen zur Messkonfiguration des Leistungszählers enthält.
Das Configuration-Mitglied enthält diese Struktur, wenn das ConfigurationType Member auf PmiMeasurementConfigurationfestgelegt ist.
Configuration.ThresholdConfiguration
Eine PMI_THRESHOLD_CONFIGURATION Struktur, die Informationen zur Schwellenwertkonfiguration des Stromzählers enthält.
Das Configuration Member enthält diese Struktur, wenn das ConfigurationType Member auf PmiThresoldConfigurationfestgelegt ist.
Bemerkungen
Die PMI_CONFIGURATION-Struktur wird verwendet, um viele verschiedene PMI-Konfigurationseinstellungen abzufragen, die von einem Stromzähler unterstützt werden.
Die PMI-Konfigurationsinformationen werden über eine IOCTL_PMI_GET_CONFIGURATION I/O-Steuerungsabfrageanforderung (IOCTL) zurückgegeben. Die Eingabedaten dieser Abfrageanforderung werden auf einen PMI_CONFIGURATION_TYPE Enumerationswert 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 und die Anforderung erfolgreich abgeschlossen wird, gibt die Anforderung eine PMI_CONFIGURATION Struktur zurück, deren Member auf die folgenden Werte festgelegt sind:
- Der ConfigurationType Member ist auf PmiBudgetingConfigurationfestgelegt.
- Das Configuration Member enthält Daten, die als PMI_BUDGETING_CONFIGURATION Struktur formatiert sind.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 7, Windows Server 2008 R2 und höheren Versionen von Windows-Betriebssystemen. |
| Header- | pmi.h (include Pmi.h) |