struktur PEP_QUERY_COMPONENT_PERF_STATES (pepfx.h)

Artikel
08/07/2023

Struktur PEP_QUERY_COMPONENT_PERF_STATES berisi daftar nilai status performa diskrit (P-state) untuk set P-state yang ditentukan.

Sintaks

typedef struct _PEP_QUERY_COMPONENT_PERF_STATES {
  [in] PEPHANDLE       DeviceHandle;
  [in] ULONG           Component;
  [in] ULONG           Set;
  [in] PPEP_PERF_STATE States;
} PEP_QUERY_COMPONENT_PERF_STATES, *PPEP_QUERY_COMPONENT_PERF_STATES;

Anggota

[in] DeviceHandle

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

[in] 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.

[in] Set

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

[in] States

Penunjuk ke buffer output. PEP menulis array struktur PEP_PERF_STATE ke buffer ini. Setiap elemen array menjelaskan satu P-state dalam set P-state yang ditentukan oleh anggota Set . Kerangka kerja manajemen daya Windows (PoFx) mengalokasikan buffer ini, yang dijamin cukup besar untuk berisi array panjang yang sebelumnya ditulis PEP kepada anggota Discrete.Count dari struktur PEP_QUERY_COMPONENT_PERF_SET sebagai respons terhadap pemberitahuan PEP_DPM_QUERY_COMPONENT_PERF_SET.

Keterangan

Struktur ini digunakan oleh pemberitahuan PEP_DPM_QUERY_COMPONENT_PERF_STATES . Keempat anggota struktur ini berisi nilai input yang disediakan oleh PoFx ketika pemberitahuan ini dikirim.