PEP_COMPONENT_PERF_SET-Struktur (pepfx.h)

  • Artikel

Die PEP_COMPONENT_PERF_SET-Struktur beschreibt die Leistungszustände (P-Zustände) in einem P-Zustandssatz.

Syntax

typedef struct _PEP_COMPONENT_PERF_SET {
  UNICODE_STRING      Name;
  ULONGLONG           Flags;
  PEP_PERF_STATE_UNIT Unit;
  PEP_PERF_STATE_TYPE Type;
  union {
    struct {
      ULONG           Count;
      PPEP_PERF_STATE States;
    } Discrete;
    struct {
      ULONGLONG Minimum;
      ULONGLONG Maximum;
    } Range;
  };
} PEP_COMPONENT_PERF_SET, *PPEP_COMPONENT_PERF_SET;

Member

Name

Eine optionale Zeichenfolge, die die Geräteeigenschaft beschreibt, die von diesem P-Zustandssatz gesteuert wird. Diese Zeichenfolge kann z. B. "Taktfrequenz" oder "Speicherbandbreite" sein. Wenn keine solche Zeichenfolge für diesen P-Zustand verfügbar ist, wird der Name-Member auf NULL festgelegt. Andernfalls enthält dieses Element einen Zeiger auf eine UNICODE_STRING-Struktur , die die Zeichenfolge enthält.

Flags

Auf NULL festlegen. Für diesen Member sind derzeit keine Flagbits definiert.

Unit

Eine PEP_PERF_STATE_UNIT-Struktur , die die Einheiten angibt, in denen die Leistungswerte für diesen P-Zustandssatz ausgedrückt werden. Die Komponentenleistung kann in Hertz (Frequenz) oder in Bits pro Sekunde (Bandbreite) ausgedrückt werden.

Type

Ein PEP_PERF_STATE_TYPE Enumerationswert, der den Typ der Leistungsinformationen angibt, die für diese Komponente angegeben werden. Dieser Member gibt an, ob die Leistungswerte für diesen P-Zustandssatz als Liste diskreter Werte oder als kontinuierlicher Wertebereich angegeben werden.

Discrete

Die Liste der diskreten Leistungswerte für diesen P-Zustandssatz.

Discrete.Count

Die Anzahl der P-Zustände in diesem P-Zustandssatz.

Discrete.States

Ein Zeiger auf ein Array von PEP_PERF_STATE Strukturen, von denen jede einen diskreten Leistungswert in diesem P-Zustandssatz beschreibt. Das Count-Element gibt die Anzahl der Elemente in diesem Array an. Ein P-Zustand wird durch seinen Arrayindex identifiziert. Wenn das Array N-Elemente enthält, reichen die P-Zustandsindizes von 0 bis N–1.

Range

Der Bereich der diskreten Leistungsmesswerte für diesen P-Zustandssatz.

Range.Minimum

Der Mindestwert im Bereich. Dieser Wert wird in den Einheiten ausgedrückt, die vom Unit-Element angegeben werden.

Range.Maximum

Der Maximalwert im Bereich. Dieser Wert wird in den Einheiten ausgedrückt, die vom Unit-Element angegeben werden.

Hinweise

Die unbenannte Union enthält die Leistungsmesswerte für diesen P-Zustand. Diese Union enthält entweder eine Liste diskreter Werte (wenn Type == PepPerfStateTypeDiscrete) oder einen kontinuierlichen Wertebereich (wenn Type == PepPerfStateTypeRange).

Das PerfStateSets-Element des PEP_COMPONENT_PERF_INFO ist das erste Element in einem Array von PEP_COMPONENT_PERF_SET Strukturen. Alle Member der PEP_COMPONENT_PERF_SET-Struktur enthalten Eingabewerte, die vom Windows Power Management Framework (PoFx) bereitgestellt werden. Das Plattformerweiterungs-Plug-In (PEP) darf nicht in diese Struktur schreiben.

Gerätetreiber verwenden die PO_FX_COMPONENT_PERF_SET-Struktur , die der PEP_COMPONENT_PERF_SET-Struktur ähnelt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Unterstützt ab Windows 10.
Kopfzeile pepfx.h (include Pep_x.h)

Weitere Informationen