PEP_QUERY_COMPONENT_PERF_SET_NAME 結構 (pepfx.h)

發行項
02/26/2024

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結構中 Components 陣列的索引，先前為 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 通知使用。當傳送此通知時， Structure 的 DeviceHandle、 Component 和 Set 成員包含 PoFx 所提供的輸入值。如果 Name 成員為非 NULL，PEP 會將字串 寫入 Name 所指向的緩衝區。如果 Name 為 NULL，PEP 會將所需的緩衝區大小寫入 NameSize 成員。

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