pepfx.h (PEP_QUERY_COMPONENT_PERF_SET 結構)

  • 發行項

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 狀態集的值是否以hz (頻率單位表示，) 或每秒 (頻寬單位) 。

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、Component、Set 和 Flags 成員包含 Windows 電源管理架構所提供的輸入值， (PoFx) 傳送此通知時提供。 Discrete 成員或 Range 成員包含 PEP 寫入結構的輸出值，以回應通知。

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

規格需求

需求 值
最低支援的用戶端 從Windows 10 開始支援。
標頭 pepfx.h (包含 Pep_x.h)

另請參閱