PEP_COMPONENT_PERF_SET 結構 (pep_x.h)
PEP_COMPONENT_PERF_SET 結構描述 P 狀態集 (P 狀態) 的效能狀態。
語法
typedef struct _PEP_COMPONENT_PERF_SET {
UNICODE_STRING Name;
ULONGLONG Flags;
PEP_PERF_STATE_UNIT Unit;
PEP_PERF_STATE_TYPE Type;
union {
struct {
ULONG Count;
PPEP_PERF_STATE States;
} Discrete;
struct {
ULONGLONG Minimum;
ULONGLONG Maximum;
} Range;
};
} PEP_COMPONENT_PERF_SET, *PPEP_COMPONENT_PERF_SET;
成員
Name
選擇性字串，描述這個 P 狀態集所控制的裝置屬性。 例如，此字串可能是「時鐘頻率」或「記憶體頻寬」。 如果這個 P 狀態沒有這類字串可用， 則 Name 成員會設定為 NULL。 否則，這個成員會包含包含字串 之UNICODE_STRING 結構的指標。
Flags
設定為零。 此成員目前未定義旗標位。
Unit
PEP_PERF_STATE_UNIT 結構，指定表示這個 P 狀態集之效能值的單位。 元件效能可以以 (頻率) 或每秒 (頻寬) 來表示。
Type
PEP_PERF_STATE_TYPE列舉值，指出為此元件指定的效能信息類型。 這個成員會指出這個 P 狀態集的效能值是指定為離散值的清單，還是指定為連續的值範圍。
Discrete
這個 P 狀態集的離散效能值清單。
Discrete.Count
這個 P 狀態集中的 P 狀態數目。
Discrete.States
PEP_PERF_STATE 結構的陣列指標，其中每一個都會描述這個 P 狀態集中的離散效能值。 Count 成員會指定這個陣列中的元素數目。 P 狀態是由其陣列索引所識別。 如果陣列包含 N 個元素，P 狀態索引的範圍從 0 到 N–1。
Range
這個 P 狀態集的離散效能測量值範圍。
Range.Minimum
範圍中的最小值。 這個值是以 Unit 成員所表示的 單位 表示。
Range.Maximum
範圍中的最大值。 這個值是以 Unit 成員所表示的 單位 表示。
備註
未命名的等位包含這個 P 狀態的效能度量值。 如果) 或連續的值範圍，則 Type == PepPerfStateTypeDiscrete 此聯集包含離散 (值的清單，如果 Type == PepPerfStateTypeRange) ，則為 (。
PEP_COMPONENT_PERF_INFO的 PerfStateSets 成員是PEP_COMPONENT_PERF_SET結構陣列中的第一個專案。 PEP_COMPONENT_PERF_SET 結構的所有成員都包含 Windows 電源管理架構所提供的輸入值， (PoFx) 。 平臺延伸模組外掛程式 (PEP) 不得寫入此結構。
設備驅動器使用 PO_FX_COMPONENT_PERF_SET 結構，類似於 PEP_COMPONENT_PERF_SET 結構。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 從Windows 10 開始支援。 |
| 標頭 | pep_x.h (包含 Pep_x.h) |