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)

另請參閱