共用方式為

PEP_COMPONENT_PERF_SET結構 （pepfx.h）

  • 發行項

PEP_COMPONENT_PERF_SET 結構描述 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

範圍中的最小值。 這個值是以 單位 成員所指示的單位表示。

Range.Maximum

範圍中的最大值。 這個值是以 單位 成員所指示的單位表示。

言論

未命名的等位包含這個 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 （include Pep_x.h）

另請參閱