PEP_QUERY_COMPONENT_PERF_SET-Struktur (pepfx.h)

  • Artikel

Die PEP_QUERY_COMPONENT_PERF_SET-Struktur enthält Abfrageinformationen zu einem Satz von Leistungszustandswerten (P-Zustandssatz) für eine Komponente.

Syntax

typedef struct _PEP_QUERY_COMPONENT_PERF_SET {
  PEPHANDLE           DeviceHandle;
  ULONG               Component;
  ULONG               Set;
  ULONGLONG           Flags;
  PEP_PERF_STATE_UNIT Unit;
  PEP_PERF_STATE_TYPE Type;
  union {
    struct {
      ULONG Count;
    } Discrete;
    struct {
      ULONGLONG Minimum;
      ULONGLONG Maximum;
    } Range;
  };
} PEP_QUERY_COMPONENT_PERF_SET, *PPEP_QUERY_COMPONENT_PERF_SET;

Member

DeviceHandle

Ein PEPHANDLE-Wert , der das Gerät identifiziert. Das PEP hat dieses Handle als Reaktion auf eine vorherige PEP_DPM_REGISTER_DEVICE Benachrichtigung bereitgestellt.

Component

Der Index, der die Komponente identifiziert. Dieser Member ist ein Index im Komponentenarray in der PEP_DEVICE_REGISTER_V2-Struktur , den pep zuvor als Reaktion auf die PEP_DPM_REGISTER_DEVICE-Benachrichtigung für dieses Gerät bereitgestellt hat. Wenn das Komponentenarray N-Elemente enthält, reichen die Komponentenindizes von 0 bis N–1.

Set

Der Index, der diesen P-Zustandssatz identifiziert. Wenn diese Komponente über M P-Zustandssätze verfügt, reichen die P-Zustandssatzindizes von 0 bis M–1. Der PEP hat zuvor die Anzahl der P-Zustandssätze als Reaktion auf eine PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES Benachrichtigung angegeben.

Flags

Ein Satz von Eingabeflags. Für dieses Element, das immer 0 ist, sind derzeit keine Flagbits definiert.

Unit

Ein PEP_PERF_STATE_UNIT Enumerationswert, der angibt, ob die Werte für diesen P-Zustandssatz in Hertz (Frequenzeinheiten) oder Bits pro Sekunde (Bandbreiteneinheiten) ausgedrückt werden.

Type

Ein PEP_PERF_STATE_TYPE Enumerationswert, der angibt, ob die Leistungswerte für diesen P-Zustandssatz als Liste diskreter Werte oder als fortlaufender Wertebereich ausgedrückt werden.

Discrete

Verwenden Sie diese Struktur, wenn Type == PepPerfStateTypeDiscrete.

Discrete.Count

Die Anzahl der diskreten Leistungswerte in diesem P-Zustandssatz.

Range

Verwenden Sie diese Struktur, wenn Type == PepPerfStateTypeRange.

Range.Minimum

Der Mindestwert im Bereich der Leistungswerte für diesen P-Zustandssatz. Dieser Wert wird in den Maßeinheiten ausgedrückt, die vom Unit-Element angegeben werden.

Range.Maximum

Der Maximalwert im Leistungsbereich für diesen P-Zustandssatz. Dieser Wert wird in den Maßeinheiten ausgedrückt, die vom Unit-Element angegeben werden.

Hinweise

Diese Struktur wird von der PEP_DPM_QUERY_COMPONENT_PERF_SET Benachrichtigung verwendet. Die Member DeviceHandle, Component, Set und Flags enthalten Eingabewerte, die vom Windows Power Management Framework (PoFx) bereitgestellt werden, wenn diese Benachrichtigung gesendet wird. Das Diskrete Element oder das Range-Element enthält einen Ausgabewert, den pep als Reaktion auf die Benachrichtigung in die Struktur schreibt.

Die unbenannte Union enthält entweder die Anzahl der diskreten Leistungswerte in diesem P-Zustandssatz oder den Wertebereich in diesem P-Zustandssatz.

Anforderungen

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

Weitere Informationen