struktur PEP_QUERY_COMPONENT_PERF_SET (pep_x.h)

  • Artikel

Struktur PEP_QUERY_COMPONENT_PERF_SET berisi informasi kueri tentang sekumpulan nilai status performa (set status P) untuk komponen.

Sintaks

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;

Anggota

DeviceHandle

Nilai PEPHANDLE yang mengidentifikasi perangkat. PEP menyediakan handel ini sebagai respons terhadap pemberitahuan PEP_DPM_REGISTER_DEVICE sebelumnya.

Component

Indeks yang mengidentifikasi komponen. Anggota ini adalah indeks ke dalam array Komponen dalam struktur PEP_DEVICE_REGISTER_V2 yang sebelumnya disediakan PEP sebagai respons terhadap pemberitahuan PEP_DPM_REGISTER_DEVICE untuk perangkat ini. Jika array Komponen berisi elemen N, indeks komponen berkisar antara 0 hingga N–1.

Set

Indeks yang mengidentifikasi set status P ini. Jika komponen ini memiliki set M P-state, indeks set P-state berkisar antara 0 hingga M–1. PEP sebelumnya menentukan jumlah set status P sebagai respons terhadap pemberitahuan PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES .

Flags

Sekumpulan bendera input. Tidak ada bit bendera yang saat ini ditentukan untuk anggota ini, yang selalu nol.

Unit

Nilai enumerasi PEP_PERF_STATE_UNIT yang menunjukkan apakah nilai untuk set status P ini dinyatakan dalam hertz (unit frekuensi) atau bit per detik (unit bandwidth).

Type

Nilai enumerasi PEP_PERF_STATE_TYPE yang menunjukkan apakah nilai performa untuk kumpulan status P ini dinyatakan sebagai daftar nilai diskrit atau sebagai rentang nilai berkelanjutan.

Discrete

Gunakan struktur ini jika Type == PepPerfStateTypeDiscrete.

Discrete.Count

Jumlah nilai performa diskrit dalam set status P ini.

Range

Gunakan struktur ini jika Type == PepPerfStateTypeRange.

Range.Minimum

Nilai minimum dalam rentang nilai performa untuk set status P ini. Nilai ini dinyatakan dalam unit pengukuran yang ditunjukkan oleh anggota Unit .

Range.Maximum

Nilai maksimum dalam rentang nilai performa untuk kumpulan status P ini. Nilai ini dinyatakan dalam unit pengukuran yang ditunjukkan oleh anggota Unit .

Keterangan

Gabungan yang tidak disebutkan namanya mewakili jumlah nilai performa diskrit dalam kumpulan status P ini, atau rentang nilai dalam kumpulan status P ini.

Struktur ini digunakan oleh pemberitahuan PEP_DPM_QUERY_COMPONENT_PERF_SET . Anggota DeviceHandle, Component, Set, dan Flags berisi nilai input yang disediakan oleh kerangka kerja manajemen daya Windows (PoFx) saat pemberitahuan ini dikirim. Anggota diskrit atau anggota Rentang berisi nilai output yang ditulis PEP ke struktur sebagai respons terhadap pemberitahuan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Didukung dimulai dengan Windows 10.
Header pep_x.h (termasuk Pep_x.h)

Lihat juga