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_CAPABILITIES-Struktur enthält Informationen über die Leistungsmessungs- und Budgetierungsfunktionen eines Stromzählers.
Syntax
typedef struct _PMI_CAPABILITIES {
ULONG Version;
ULONG Size;
PMI_CAPABILITIES_TYPE CapabilityType;
union {
PMI_REPORTED_CAPABILITIES ReportedCapabilities;
PMI_METERED_HARDWARE_INFORMATION MeteredHardwareInformation;
} Capabilities;
} PMI_CAPABILITIES, *PPMI_CAPABILITIES;
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.
CapabilityType
Ein PMI_CAPABILITIES_TYPE Enumerationswert, der den Datentyp des mitglieds Capabilities angibt.
Capabilities
Eine Vereinigung der unterstützten Power Meter Interface (PMI)-Funktionsstrukturen. Basierend auf dem Wert des members CapabilityType wird eins der folgenden Capabilities-Untermembers verwendet, um auf die folgenden PMI-Funktionsstrukturen zu verweisen:
Capabilities.ReportedCapabilities
Eine PMI_METERED_HARDWARE_INFORMATION Struktur, die mindestens ein Hardwaregerät angibt, das vom Stromzähler überwacht wird.
Das Capabilities Member enthält diese Struktur, wenn das CapabilityType Member auf PmiMeteredHardwarefestgelegt ist.
Capabilities.MeteredHardwareInformation
Eine PMI_REPORTED_CAPABILITIES Struktur, die die PMI-Funktionen des Leistungszählers angibt, z. B. folgendes:
- Objektinformationen
- Messfunktionen
- Leistungs- und Budgetfunktionen
Bemerkungen
Die PMI_CAPABILITIES-Struktur wird verwendet, um viele PMI-Funktionen abzufragen, die von einem Stromzähler unterstützt werden.
Die PMI-Funktionsinformationen werden über eine IOCTL_PMI_GET_CAPABILITIES I/O-Steuerelement-Abfrageanforderung (IOCTL) zurückgegeben. Die Eingabedaten für diese Abfrageanforderung werden auf einen PMI_CAPABILITIES_TYPE Enumerationswert festgelegt, der den Typ der zurückzugebenden PMI-Funktionsdaten angibt.
Wenn die IOCTL-Abfrageanforderung erfolgreich abgeschlossen wird, gibt die Anforderung eine PMI_CAPABILITIES Struktur zurück. Das Capabilities Member dieser Struktur enthält Daten, die als angeforderte PMI-Funktionsstruktur formatiert sind.
Wenn beispielsweise eine IOCTL-Abfrageanforderung von IOCTL_PMI_GET_CAPABILITIES mit dem Eingabedatensatz an PmiReportedCapabilities und die Anforderung erfolgreich abgeschlossen wird, gibt die Anforderung eine PMI_CAPABILITIES Struktur zurück, deren Member auf die folgenden Werte festgelegt sind:
- Der CapabilitiesType Member ist auf PmiReportedCapabilitiesfestgelegt.
- Das Capabilities Member enthält Daten, die als PMI_REPORTED_CAPABILITIES 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) |