PMI_REPORTED_CAPABILITIES-Struktur (pmi.h)

Artikel
02/29/2024

Die PMI_REPORTED_CAPABILITIES-Struktur enthält Informationen zum Typ der Leistungsmessungs- und Budgetierungsfunktionen, die ein Stromzähler unterstützt. Darüber hinaus enthält diese Struktur Ressourceninformationen über den Stromzähler selbst.

Syntax

typedef struct _PMI_REPORTED_CAPABILITIES {
  ULONG                Flags;
  PMI_MEASUREMENT_UNIT MeasurementUnit;
  PMI_MEASUREMENT_TYPE MeasurementType;
  ULONG                Accuracy;
  ULONG                SamplingPeriod;
  ULONG                MinimumAverageInterval;
  ULONG                MaximumAverageInterval;
  ULONG                Hysteresis;
  BOOLEAN              Writeable;
  ULONG                MinBudget;
  ULONG                MaxBudget;
  WCHAR                ModelNumber[PMI_NAME_MAX];
  WCHAR                SerialNumber[PMI_NAME_MAX];
  WCHAR                OEMInformation[PMI_NAME_MAX];
} PMI_REPORTED_CAPABILITIES, *PPMI_REPORTED_CAPABILITIES;

Member

Flags

Eine Bitmaske, die die unterstützten Funktionen des Stromzählers angibt. Die folgenden Flags definieren den Wertebereich für dieses Element:

PMI_CAPABILITIES_SUPPORT_MEASUREMENT

Dieses Bit wird festgelegt, wenn das Leistungsmessgerät die Leistungsmessung unterstützt.

PMI_CAPABILITIES_SUPPORT_THRESHOLDS

Dieses Bit wird festgelegt, wenn der Stromzähler Leistungsschwellenwerte unterstützt.

PMI_CAPABILITIES_SUPPORT_BUDGETING

Dieses Bit wird festgelegt, wenn der Stromzähler die Strombudgetierung unterstützt.

PMI_CAPABILITIES_DISCHARGE_ONLY

Dieses Bit wird festgelegt, wenn der Stromzähler Daten nur meldet, wenn das Netzteil entladen wird. Dies ist in der Regel bei mobilen Batteriesystemen oder einigen unterbrechungsfreien Netzteilen (UPSs) der Fall.

MeasurementUnit

Ein PMI_MEASUREMENT_UNIT Enumerationswert, der die Maßeinheit angibt.

Hinweis Ab Windows 7, Windows Server 2008 R2 werden nur Maßeinheiten von Milliwatt (mW) unterstützt.

MeasurementType

Ein PMI_MEASUREMENT_TYPE Enumerationswert, der den Messtyp angibt, z. B. ob die Eingangs- oder Ausgangsleistung gemessen wird.

Accuracy

Ein Wert in Tausendstelprozenteinheiten, der die gemeldete Genauigkeit des Leistungszählers angibt. Beispielsweise entspricht ein Wert von 1.000 einer Genauigkeitsbewertung von 1 Prozent.

SamplingPeriod

Ein Wert in Millisekundeneinheiten, der den aktuellen Durchschnittszeitraum angibt.

MinimumAverageInterval

Ein Wert in Millisekundeneinheiten, der das minimale Durchschnittsintervall angibt.

MaximumAverageInterval

Ein Wert in Millisekundeneinheiten, der das maximale Durchschnittsintervall angibt.

Hysteresis

Ein Wert in Millisekundeneinheiten, der den Hysteresewert angibt. Dieser Wert gibt die Marge an, die um den Schwellenwert und die Budgetereignisse herum erstellt wird. Dieser Wert verhindert das Auslösen unnötiger Ereignisse, wenn der Wert sehr nahe an einem der Schwellenwerte schwankt.

Writeable

Ein boolescher Wert, der angibt, ob die Budgetierungsinformationen Lese-/Schreibzugriff (TRUE) oder schreibgeschützt (FALSE) sind.

MinBudget

Ein Wert in Watteinheiten, der das unterstützte Mindestleistungsbudget angibt.

MaxBudget

Ein Wert in Watteinheiten, der das maximal unterstützte Leistungsbudget angibt.

ModelNumber[PMI_NAME_MAX]

Eine mit NULL endende Unicode-Zeichenfolge, die die Modellnummer des Leistungszählers enthält.

SerialNumber[PMI_NAME_MAX]

Eine unicode-Zeichenfolge mit Null-Termin, die die Seriennummer des Stromzählers enthält.

OEMInformation[PMI_NAME_MAX]

Eine mit NULL endende Unicode-Zeichenfolge, die beschreibende Informationen zum Leistungsmesser enthält. Diese Informationen beziehen sich spezifisch auf die Implementierung durch den ursprünglichen OEM.

Hinweise

Die PMI_REPORTED_CAPABILITIES-Struktur enthält die folgenden Informationen zu einem Stromzähler:

Die Messfunktionen des Leistungszählers.
Die Budgetfunktionen des Stromzählers, einschließlich der Möglichkeit, die Budgetkonfiguration zu ändern.
Die Ressourceninformationen des Stromzählers. Diese Informationen werden vom OEM für das Leistungsmessgerät definiert.

Die PMI_REPORTED_CAPABILITIES-Struktur wird über eine Abfrageanforderung des IOCTL_PMI_GET_CAPABILITIES E/A-Steuerelements (IOCTL) zurückgegeben. Die Eingabedaten für diese Abfrageanforderung werden auf den PMI_CAPABILITIES_TYPE Enumeratorwert von PmiReportedCapabilities. festgelegt.

Wenn die Abfrageanforderung erfolgreich abgeschlossen wurde, gibt die Anforderung eine PMI_CAPABILITIES-Struktur zurück. Der Capabilities-Member dieser Struktur ist als PMI_REPORTED_CAPABILITIES-Struktur formatiert.

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 (pmi.h einschließen)