共用方式為

PEP_QUERY_COMPONENT_PERF_SET結構 （pepfx.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 結構中 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 狀態集效能值範圍內的最大值。 此值會以 單位 成員所表示的度量單位表示。

言論

PEP_DPM_QUERY_COMPONENT_PERF_SET 通知會使用此結構。 DeviceHandle、元件、設定和 旗標 成員包含傳送此通知時 Windows 電源管理架構 （PoFx） 所提供的輸入值。 Discrete 成員或 Range 成員包含 PEP 寫入結構的輸出值，以回應通知。

未命名的等位包含這個 P 狀態集中的離散效能值數目，或這個 P 狀態集中的值範圍。

要求

要求 價值
最低支援的用戶端 從 Windows 10 開始支援。
標頭 pepfx.h （include Pep_x.h）

另請參閱