PO_FX_COMPONENT_PERF_SET結構 （wdm.h）

PO_FX_COMPONENT_PERF_SET 結構代表裝置內單一元件的一組效能狀態。

語法

C++

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;

成員

Name

選擇性字元字串，用來描述由效能狀態集控制的元件屬性。 例如，「時鐘頻率」或「記憶體頻寬」。

Flags

設定為 0。 目前沒有為此成員定義旗標。

Unit

PO_FX_PERF_STATE_UNIT 值，指定由效能狀態集控制的單位類型。

Type

PO_FX_PERF_STATE_TYPE 值，指定集合中效能狀態的類型（離散數目的狀態或最小值與最大值之間的狀態連續分佈）。

Discrete

對於代表離散數目效能狀態的集合（也就是，Type 成員是 PoFxPerfStateTypeDiscrete），這個巢狀結構描述狀態。

Discrete.Count

集合中的效能狀態數目。

Discrete.States

PO_FX_PERF_STATE 陣列的指標。 這個陣列的長度是由 Count 成員所指定。 每個陣列元素都會描述集合中的一個電源狀態。

Range

對於代表效能狀態連續分佈的集合（也就是，Type 成員是 PoFxPerfStateTypeRange），這個巢狀結構描述效能狀態範圍的最小值和最大值。

Range.Minimum

最小效能狀態值。

Range.Maximum

最大效能狀態值。

言論

當設備驅動器呼叫 PoFxRegisterComponentPerfStates 例程，向電源管理架構 （PoFx） 註冊元件以取得效能狀態支援時，驅動程式可以提供 PO_FX_COMPONENT_PERF_INFO 結構，描述元件支援的效能狀態集合。 PO_FX_COMPONENT_PERF_INFO 結構 成員 PerfStateSets 包含代表支援效能狀態之 PO_FX_COMPONENT_PERF_SET 結構的陣列。

大部分的驅動程式都預期會為每個元件定義一組效能狀態。 例如，驅動程式可能會定義一組效能狀態，以控制元件的時鐘頻率。 不過，某些驅動程式可能需要定義一個以上的效能狀態集，以控制元件的多個效能狀態維度。 例如，驅動程式可能會定義兩組效能狀態，以控制時鐘頻率和總線頻寬。

要求

要求	價值
最低支援的用戶端	從 Windows 10 開始支援。
標頭	wdm.h （包括 Wudfwdm.h）

另請參閱

裝置效能狀態管理

PO_FX_COMPONENT_PERF_INFO

PoFxRegisterComponentPerfStates