PEP_QUERY_COMPONENT_PERF_SET_NAME結構 （pepfx.h）

PEP_QUERY_COMPONENT_PERF_SET_NAME 結構包含元件一組效能狀態值 （P 狀態集） 的查詢資訊。

語法

typedef struct _PEP_QUERY_COMPONENT_PERF_SET_NAME {
  [in]      PEPHANDLE DeviceHandle;
  [in]      ULONG     Component;
  [in]      ULONG     Set;
  [in, out] USHORT    NameSize;
  [in]      PWCHAR    Name;
} PEP_QUERY_COMPONENT_PERF_SET_NAME, *PPEP_QUERY_COMPONENT_PERF_SET_NAME;

成員

[in] DeviceHandle

識別裝置的 PEPHANDLE 值。 PEP 提供了此句柄，以回應先前的 PEP_DPM_REGISTER_DEVICE 通知。

[in] Component

識別元件的索引。 此成員是 PEP_DEVICE_REGISTER_V2 結構中 PEP 先前針對此裝置 PEP_DPM_REGISTER_DEVICE 通知提供的 Components 陣列的索引。 如果 元件 數位件包含 N 個元素，元件索引的範圍從 0 到 N–1。

[in] Set

識別這個 P 狀態集的索引。 如果此元件具有 M P 狀態集合，P 狀態集索引的範圍從 0 到 M–1。 PEP 先前已指定 P 狀態集的數目，以回應 PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES 通知。

[in, NameSize

在輸入時，Name 成員所指向之緩衝區的大小，以位元組為單位。 如果 Name 為 NULL，PEP 會以名稱字串所需的緩衝區大小覆寫 NameSize 的輸入值。

[in] Name

輸出緩衝區的指標。 PEP 會將 P 狀態的名稱寫入這個緩衝區。 名稱會儲存為寬字元、以 Null 結尾的字串。 如果 Windows 電源管理架構 （PoFx） 需要判斷要配置給名稱字串的緩衝區大小，Name 成員為 NULL。 如果 Name 為非 NULL，則緩衝區必須足夠大，才能包含整個字串，包括終止的 Null 字元。

言論

PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME 通知會使用此結構。 DeviceHandle、元件，以及 設定 結構 成員包含傳送此通知時 PoFx 提供的輸入值。 如果 名稱 成員不是 NULL，PEP 會將字串寫入 Name 所指向的緩衝區。 如果 Name 為 NULL，PEP 會將所需的緩衝區大小寫入 NameSize 成員。

PEP 寫入輸出緩衝區的字串應該包含 P 狀態集的描述性名稱。 此名稱旨在讓記錄項目和診斷訊息更容易瞭解。

要求

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

另請參閱

PEP_DEVICE_REGISTER_V2

PEP_DPM_QUERY_COMPONENT_PERF_CAPABILITIES

PEP_DPM_QUERY_COMPONENT_PERF_SET_NAME

PEP_DPM_REGISTER_DEVICE