PO_FX_COMPONENT_PERF_SET 結構 (wdm.h)
PO_FX_COMPONENT_PERF_SET 結構代表裝置內單一元件的一組效能狀態。
語法
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) |