PEP_QUERY_COMPONENT_PERF_SET 結構 (pep_x.h)
PEP_QUERY_COMPONENT_PERF_SET 結構包含一組效能狀態值的查詢資訊, (元件的 P 狀態集) 。
語法
typedef struct _PEP_QUERY_COMPONENT_PERF_SET {
PEPHANDLE DeviceHandle;
ULONG Component;
ULONG Set;
ULONGLONG Flags;
PEP_PERF_STATE_UNIT Unit;
PEP_PERF_STATE_TYPE Type;
union {
struct {
ULONG Count;
} Discrete;
struct {
ULONGLONG Minimum;
ULONGLONG Maximum;
} Range;
};
} PEP_QUERY_COMPONENT_PERF_SET, *PPEP_QUERY_COMPONENT_PERF_SET;
成員
DeviceHandle
可識別裝置的 PEPHANDLE 值。 PEP 提供此句柄,以回應先前 的PEP_DPM_REGISTER_DEVICE 通知。
Component
識別元件的索引。 這個成員是PEP_DEVICE_REGISTER_V2結構中 Components 陣列的索引,先前為 PEP 提供,以回應此裝置的PEP_DPM_REGISTER_DEVICE通知。 如果 Components 陣列包含 N 個元素,元件索引的範圍從 0 到 N–1。
Set
識別這個 P 狀態集的索引。 如果此元件具有 M P 狀態集合,P 狀態集索引的範圍從 0 到 M–1。 PEP 先前指定了 P 狀態集的數目,以回應 PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES 通知。
Flags
一組輸入旗標。 此成員目前未定義旗標位,一律為零。
Unit
PEP_PERF_STATE_UNIT列舉值,指出這個 P 狀態集的值是否以 () 頻率單位) 或每秒的位數來表示, (頻寬單位) 。
Type
PEP_PERF_STATE_TYPE列舉值,指出這個 P 狀態集的效能值是以離散值清單或連續值範圍表示。
Discrete
如果 Type == PepPerfStateTypeDiscrete
,請使用這個結構。
Discrete.Count
這個 P 狀態集中的離散效能值數目。
Range
如果 Type == PepPerfStateTypeRange
,請使用這個結構。
Range.Minimum
這個 P 狀態集效能值範圍內的最小值。 這個值是以 單位 成員所表示的度量單位表示。
Range.Maximum
這個 P 狀態集效能值範圍中的最大值。 這個值是以 單位 成員所表示的度量單位表示。
備註
未命名的等位代表這個 P 狀態集中的離散效能值數目,或這個 P 狀態集中的值範圍。
此結構由 PEP_DPM_QUERY_COMPONENT_PERF_SET 通知使用。 DeviceHandle、Component、Set 和 Flags 成員包含 Windows 電源管理架構所提供的輸入值, (PoFx 在傳送此通知時) 。 離散成員或 Range 成員包含 PEP 寫入結構的輸出值,以回應通知。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 從Windows 10 開始支援。 |
標頭 | pep_x.h (包含 Pep_x.h) |