Freigeben über

PEP_QUERY_COMPONENT_PERF_SET-Struktur (pep_x.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. Dieses Element ist ein Index in das Array Components in der PEP_DEVICE_REGISTER_V2-Struktur , das der 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

Eine Reihe 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 kontinuierlicher Wertebereich ausgedrückt werden.

Discrete

Verwenden Sie diese Struktur, wenn Type == PepPerfStateTypeDiscrete.

Discrete.Count

Die Anzahl diskreter 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 Vom Unit-Element angegebenen Maßeinheiten ausgedrückt.

Range.Maximum

Der maximale Wert im Bereich der Leistungswerte für diesen P-Zustandssatz. Dieser Wert wird in den Vom Unit-Element angegebenen Maßeinheiten ausgedrückt.

Hinweise

Die unbenannte Union stellt entweder die Anzahl diskreter Leistungswerte in diesem P-Zustandssatz oder den Wertebereich in diesem P-Zustandssatz dar.

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 Bereichselement enthält einen Ausgabewert, den pep als Reaktion auf die Benachrichtigung in die Struktur schreibt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Wird ab Windows 10 unterstützt.
Kopfzeile pep_x.h (einschließlich Pep_x.h)

Weitere Informationen