struktur PEP_QUERY_COMPONENT_PERF_SET_NAME (pep_x.h)

  • Artikel

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

Sintaks

typedef struct _PEP_QUERY_COMPONENT_PERF_SET_NAME {
  [in]      PEPHANDLE DeviceHandle;
  [in]      ULONG     Component;
  [in]      ULONG     Set;
  [in, out] USHORT    NameSize;
  [in]      PWCHAR    Name;
} PEP_QUERY_COMPONENT_PERF_SET_NAME, *PPEP_QUERY_COMPONENT_PERF_SET_NAME;

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 komponen ini memiliki set M P-state, indeks set status P berkisar dari 0 hingga M–1. PEP sebelumnya menentukan jumlah set status P sebagai respons terhadap pemberitahuan PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES .

[in, NameSize

Pada input, ukuran, dalam byte, dari buffer yang ditujukkan oleh anggota Nama . Jika Nama NULL, PEP menimpa nilai input NameSize dengan ukuran buffer yang diperlukan untuk string nama.

[in] Name

Penunjuk ke buffer output. PEP menulis nama status P ke buffer ini. Nama disimpan sebagai string karakter lebar dan dihentikan null. Anggota Nama adalah NULL jika kerangka kerja manajemen daya Windows (PoFx) perlu menentukan seberapa besar buffer untuk dialokasikan untuk string nama. Jika Nama bukan NULL, buffer harus cukup besar untuk berisi seluruh string, termasuk karakter null yang mengakhiri.

Keterangan

Struktur ini digunakan oleh pemberitahuan PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME . DeviceHandle, Component, dan Set anggota struktur berisi nilai input yang disediakan oleh PoFx saat pemberitahuan ini dikirim. Jika anggota Nama bukan NULL, PEP menulis string ke buffer yang diacu oleh Nama. Jika Nama NULL, PEP menulis ukuran buffer yang diperlukan ke anggota NameSize .

String yang ditulis PEP ke buffer output harus berisi nama deskriptif untuk set P-state. Nama ini dimaksudkan untuk membuat entri log dan pesan diagnostik lebih mudah dipahami.

Persyaratan

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

Lihat juga

PEP_DEVICE_REGISTER_V2

PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES

PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME

PEP_DPM_REGISTER_DEVICE