共用方式為


pepfx.h) (PEP_COMPONENT_PERF_SET 結構

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_INFOPerfStateSets 成員是PEP_COMPONENT_PERF_SET結構陣列中的第一個專案。 PEP_COMPONENT_PERF_SET結構的所有成員都包含 Windows 電源管理架構所提供的輸入值, (PoFx) 。 平臺擴充功能外掛程式 (PEP) 不得寫入此結構。

設備驅動器會使用 PO_FX_COMPONENT_PERF_SET 結構,類似於 PEP_COMPONENT_PERF_SET 結構。

規格需求

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

另請參閱