struktur PO_FX_COMPONENT_PERF_SET (wdm.h)

  • Artikel

Struktur PO_FX_COMPONENT_PERF_SET mewakili serangkaian status performa untuk satu komponen dalam perangkat.

Sintaks

typedef struct _PO_FX_COMPONENT_PERF_SET {
  UNICODE_STRING        Name;
  ULONGLONG             Flags;
  PO_FX_PERF_STATE_UNIT Unit;
  PO_FX_PERF_STATE_TYPE Type;
  union {
    struct {
      ULONG             Count;
      PPO_FX_PERF_STATE States;
    } Discrete;
    struct {
      ULONGLONG Minimum;
      ULONGLONG Maximum;
    } Range;
  };
} PO_FX_COMPONENT_PERF_SET, *PPO_FX_COMPONENT_PERF_SET;

Anggota

Name

String karakter opsional yang digunakan untuk menjelaskan properti komponen yang dikontrol oleh set status performa. Misalnya, "Frekuensi jam" atau "Bandwidth memori".

Flags

Atur ke 0. Saat ini, tidak ada bendera yang ditentukan untuk anggota ini.

Unit

Nilai PO_FX_PERF_STATE_UNIT yang menentukan jenis unit yang dikontrol oleh set status performa.

Type

Nilai PO_FX_PERF_STATE_TYPE yang menentukan jenis status performa dalam set (jumlah status diskrit atau distribusi status berkelanjutan antara nilai minimum dan maksimum).

Discrete

Untuk set yang mewakili jumlah status performa diskrit (yaitu, di mana anggota Jenis adalah PoFxPerfStateTypeDiscrete), struktur berlapis ini menjelaskan status.

Discrete.Count

Jumlah status performa dalam set.

Discrete.States

Penunjuk ke array PO_FX_PERF_STATE . Panjang array ini ditentukan oleh anggota Count . Setiap elemen array menjelaskan satu status daya dalam set.

Range

Untuk set yang mewakili distribusi status performa berkelanjutan (yaitu, di mana anggota Jenis adalah PoFxPerfStateTypeRange), struktur berlapis ini menjelaskan nilai minimum dan maksimum dari rentang status performa.

Range.Minimum

Nilai status performa minimum.

Range.Maximum

Nilai status performa maksimum.

Keterangan

Ketika driver perangkat memanggil rutinitas PoFxRegisterComponentPerfStates untuk mendaftarkan komponen untuk dukungan status performa dengan kerangka kerja manajemen daya (PoFx), driver dapat menyediakan struktur PO_FX_COMPONENT_PERF_INFO yang menjelaskan set status performa yang didukung oleh komponen. Anggota PerfStateSets dari struktur PO_FX_COMPONENT_PERF_INFO berisi array struktur PO_FX_COMPONENT_PERF_SET yang mewakili status performa yang didukung.

Sebagian besar driver diharapkan untuk menentukan satu set status performa per komponen. Misalnya, driver mungkin menentukan satu set status performa untuk mengontrol frekuensi jam untuk komponen. Namun, beberapa driver mungkin perlu menentukan lebih dari satu status performa yang diatur untuk mengontrol beberapa dimensi status performa untuk komponen. Misalnya, driver mungkin menentukan dua set status performa untuk mengontrol frekuensi jam dan bandwidth bus.

Persyaratan

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

Lihat juga

Manajemen Status Performa Perangkat

PO_FX_COMPONENT_PERF_INFO

PoFxRegisterComponentPerfStates