struktur PEP_COMPONENT_PERF_SET (pep_x.h)

  • Artikel

Struktur PEP_COMPONENT_PERF_SET menjelaskan status performa (P-states) dalam set P-state.

Sintaks

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;

Anggota

Name

String opsional yang menjelaskan properti perangkat yang dikontrol oleh set status P ini. Misalnya, string ini mungkin "Frekuensi jam" atau "Bandwidth memori". Jika tidak ada string yang tersedia untuk status P ini, anggota Nama diatur ke NULL. Jika tidak, anggota ini berisi pointer ke struktur UNICODE_STRING yang berisi string.

Flags

Atur ke nol. Tidak ada bit bendera yang saat ini ditentukan untuk anggota ini.

Unit

Struktur PEP_PERF_STATE_UNIT yang menentukan unit tempat nilai performa untuk kumpulan status P ini dinyatakan. Performa komponen dapat dinyatakan dalam hertz (frekuensi) atau dalam bit per detik (bandwidth).

Type

Nilai enumerasi PEP_PERF_STATE_TYPE yang menunjukkan jenis informasi performa yang ditentukan untuk komponen ini. Anggota ini menunjukkan apakah nilai performa untuk set status P ini ditentukan sebagai daftar nilai diskrit atau sebagai rentang nilai berkelanjutan.

Discrete

Daftar nilai performa diskrit untuk kumpulan status P ini.

Discrete.Count

Jumlah P-states dalam set P-state ini.

Discrete.States

Penunjuk ke array struktur PEP_PERF_STATE , yang masing-masing menjelaskan nilai performa diskrit dalam set P-state ini. Anggota Count menentukan jumlah elemen dalam array ini. Status P diidentifikasi oleh indeks array-nya. Jika array berisi elemen N, indeks status P berkisar antara 0 hingga N–1.

Range

Rentang nilai pengukuran performa diskrit untuk kumpulan P-state ini.

Range.Minimum

Nilai minimum dalam rentang. Nilai ini dinyatakan dalam unit yang ditunjukkan oleh anggota Unit .

Range.Maximum

Nilai maksimum dalam rentang. Nilai ini dinyatakan dalam unit yang ditunjukkan oleh anggota Unit .

Keterangan

Gabungan yang tidak disebutkan namanya berisi nilai pengukuran performa untuk status P ini. Serikat ini berisi daftar nilai diskrit (jika Type == PepPerfStateTypeDiscrete) atau rentang nilai berkelanjutan (jika Type == PepPerfStateTypeRange).

Anggota PerfStateSets dari PEP_COMPONENT_PERF_INFO adalah elemen pertama dalam array struktur PEP_COMPONENT_PERF_SET . Semua anggota struktur PEP_COMPONENT_PERF_SET berisi nilai input yang disediakan oleh kerangka kerja manajemen daya Windows (PoFx). Plug-in ekstensi platform (PEP) tidak boleh menulis ke struktur ini.

Driver perangkat menggunakan struktur PO_FX_COMPONENT_PERF_SET , yang mirip dengan struktur PEP_COMPONENT_PERF_SET .

Persyaratan

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

Lihat juga