PMI_CAPABILITIES-Struktur (pmi.h)
Die PMI_CAPABILITIES-Struktur enthält Informationen zu den Leistungsmessungs- und Budgetierungsfunktionen eines Leistungsmessgeräts.
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;
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.
CapabilityType
Ein PMI_CAPABILITIES_TYPE Enumerationswert, der den Datentyp des Capabilities-Members angibt.
Capabilities
Eine Union der unterstützten Power Meter Interface-Funktionsstrukturen (PMI). Basierend auf dem Wert des CapabilityType-Members wird eine der folgenden Untergruppen Capabilities 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 Strommessgerät überwacht wird.
Das Capabilities-Member enthält diese Struktur, wenn das CapabilityType-Element auf PmiMeteredHardware festgelegt ist.
Capabilities.MeteredHardwareInformation
Eine PMI_REPORTED_CAPABILITIES-Struktur , die die PMI-Funktionen des Leistungsmessgeräts angibt, z. B.:
- Ressourceninformationen
- Messfunktionen
- Power- und Budgetfunktionen
Hinweise
Die PMI_CAPABILITIES-Struktur wird verwendet, um viele PMI-Funktionen abzufragen, die von einem Power Meter unterstützt werden.
Die INFORMATIONEN zur PMI-Funktion werden über eine Abfrageanforderung IOCTL_PMI_GET_CAPABILITIES E/A-Steuerelements (IOCTL) zurückgegeben. Die Eingabedaten für diese Abfrageanforderung sind auf einen PMI_CAPABILITIES_TYPE Enumeratorwert festgelegt, der den Typ der zurückzugebenden PMI-Funktionsdaten angibt.
Wenn die IOCTL-Abfrageanforderung erfolgreich abgeschlossen wurde, gibt die Anforderung eine PMI_CAPABILITIES-Struktur zurück. Das Capabilities-Element 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 erfolgt und die Anforderung erfolgreich abgeschlossen wird, gibt die Anforderung eine PMI_CAPABILITIES-Struktur zurück, deren Member auf die folgenden Werte festgelegt sind:
- Das CapabilitiesType-Element ist auf PmiReportedCapabilities festgelegt.
- Das Capabilities-Element enthält Daten, die als PMI_REPORTED_CAPABILITIES-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) |