struktur PEP_REQUEST_COMPONENT_PERF_STATE (pep_x.h)

Artikel
08/07/2023

Struktur PEP_REQUEST_COMPONENT_PERF_STATE berisi daftar perubahan status performa (P-state) yang diminta oleh kerangka kerja manajemen daya Windows (PoFx), ditambah informasi status tentang penanganan permintaan ini oleh plug-in ekstensi platform (PEP).

Sintaks

typedef struct _PEP_REQUEST_COMPONENT_PERF_STATE {
  [in]  PEPHANDLE                         DeviceHandle;
  [in]  ULONG                             Component;
  [out] BOOLEAN                           Completed;
  [out] BOOLEAN                           Succeeded;
  [in]  ULONG                             PerfRequestsCount;
  [in]  PPEP_COMPONENT_PERF_STATE_REQUEST PerfRequests;
} PEP_REQUEST_COMPONENT_PERF_STATE, *PPEP_REQUEST_COMPONENT_PERF_STATE;

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.

[out] Completed

Apakah PEP telah menyelesaikan perubahan status P yang diminta. Atur ke TRUE untuk menunjukkan bahwa perubahan status P selesai secara sinkron. Atur ke FALSE untuk menunjukkan bahwa perubahan status P yang diminta tertunda dan akan diselesaikan secara asinkron oleh utas pekerja PEP. Untuk informasi selengkapnya, lihat Keterangan.

[out] Succeeded

Apakah perubahan status P yang diminta berhasil diselesaikan. Atur ke TRUE jika PEP berhasil menyelesaikan semua perubahan status P yang diminta dalam array PerfRequests . Atur ke FALSE jika PEP tidak dapat melakukan semua perubahan status P yang diminta, dalam hal ini status P dalam perangkat keras dibiarkan tidak berubah. Anggota Berhasil hanya digunakan untuk perubahan status P sinkron . Jika set PEP Selesai ke FALSE, PoFx mengabaikan nilai di anggota Berhasil .

[in] PerfRequestsCount

Jumlah perubahan status P yang diminta dalam array yang ditujukkan oleh anggota PerfRequests .

[in] PerfRequests

Penunjuk ke array struktur PEP_COMPONENT_PERF_STATE_REQUEST . Setiap elemen dalam array menentukan tingkat performa baru untuk ditetapkan ke set P-state. Jumlah elemen array ditentukan oleh anggota PerfRequestsCount .

Keterangan

Struktur ini digunakan oleh pemberitahuan PEP_DPM_REQUEST_COMPONENT_PERF_STATE . Anggota DeviceHandle, Component, PerfRequestsCount, dan PerfRequests struktur berisi nilai input yang disediakan oleh PoFx saat pemberitahuan ini dikirim. Anggota Selesai dan Berhasil berisi nilai output yang ditulis PEP ke struktur sebagai respons terhadap pemberitahuan.

PEP dapat menyelesaikan perubahan status P yang diminta baik secara sinkron atau asinkron. PEP dapat mengatur anggota Selesai ke TRUE untuk menunjukkan bahwa semua permintaan dalam pemberitahuan PEP_DPM_REQUEST_COMPONENT_PERF_STATE telah diselesaikan secara sinkron—yaitu, sebelum pengembalian dari rutinitas panggilan balik AcceptDeviceNotification PEP. Atau, PEP dapat mengatur Selesai ke FALSE untuk menunjukkan bahwa permintaan akan diselesaikan secara asinkron. Untuk menyelesaikan permintaan secara asinkron, PEP harus memanggil rutinitas RequestWorker untuk memberi tahu PoFx bahwa PEP memiliki permintaan kerja untuk dikirimkan, dan PoFx akan merespons dengan mengirim pemberitahuan PEP_DPM_WORK ke PEP.

PoFx menulis perubahan status P yang diminta ke array PerfRequests sebelum pemberitahuan PEP_DPM_REQUEST_COMPONENT_PERF_STATE dikirim. Jika PEP menangani perubahan status P yang diminta secara sinkron, konten array PerfRequests tetap valid hanya sampai pengembalian dari rutinitas panggilan balik AcceptDeviceNotification . Jika permintaan selesai secara asinkron, konten array tetap valid sampai PEP memanggil rutinitas CompleteWork untuk memberi tahu PoFx bahwa PEP telah menyelesaikan permintaan yang tertunda.