PEP_REQUEST_COMPONENT_PERF_STATE 結構 (pep_x.h)

發行項
02/26/2024

PEP_REQUEST_COMPONENT_PERF_STATE 結構包含 Windows 電源管理架構 (PoFx) 所要求的效能狀態 (P 狀態) 變更清單，以及平臺擴充功能外掛程式 (PEP) 處理這些要求的狀態資訊。

語法

typedef struct _PEP_REQUEST_COMPONENT_PERF_STATE {
  [in]  PEPHANDLE                         DeviceHandle;
  [in]  ULONG                             Component;
  [out] BOOLEAN                           Completed;
  [out] BOOLEAN                           Succeeded;
  [in]  ULONG                             PerfRequestsCount;
  [in]  PPEP_COMPONENT_PERF_STATE_REQUEST PerfRequests;
} PEP_REQUEST_COMPONENT_PERF_STATE, *PPEP_REQUEST_COMPONENT_PERF_STATE;

成員

[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。

[out] Completed

PEP 是否已完成要求的 P 狀態變更。設定為 TRUE，表示 P 狀態變更會同步完成。設定為 FALSE，表示要求的 P 狀態變更擱置中，且 PEP 背景工作線程會以異步方式完成。如需詳細資訊，請參閱＜備註＞。

[out] Succeeded

要求的 P 狀態變更是否成功完成。如果 PEP 成功完成 PerfRequests 陣列中要求的所有 P 狀態變更，請設定為 TRUE。如果 PEP 無法執行所有要求的 P 狀態變更，則設定為 FALSE，在此情況下，硬體中的 P 狀態會保持不變。 Succeeded 成員僅用於同步 P 狀態變更。如果 PEP 將 Completed 設定為 FALSE，PoFx 會忽略 Succeeded 成員中的值。

[in] PerfRequestsCount

PerfRequests 成員指向之陣列中要求的 P 狀態變更數目。

[in] PerfRequests

PEP_COMPONENT_PERF_STATE_REQUEST 結構的陣列指標。陣列中的每個元素都會指定要指派給 P 狀態集的新效能等級。陣列元素的數目是由 PerfRequestsCount 成員所指定。

備註

此結構是由 PEP_DPM_REQUEST_COMPONENT_PERF_STATE 通知使用。 結構的 DeviceHandle、Component、PerfRequestsCount 和 PerfRequests 成員包含傳送此通知時 PoFx 所提供的輸入值。 Completed 和 Succeeded 成員包含 PEP 寫入結構的輸出值，以回應通知。

PEP 可以同步或異步完成要求的 P 狀態變更。 PEP 可以將 Completed 成員設定為 TRUE，以指出 PEP_DPM_REQUEST_COMPONENT_PERF_STATE 通知中的所有要求都已同步完成，也就是從 PEP 的 AcceptDeviceNotification 回呼例程傳回之前。或者，PEP 可以將 Completed 設定為 FALSE，以表示要求會以異步方式完成。若要以異步方式完成要求，PEP 應該呼叫 RequestWorker 例程，通知 PoFx PEP 有要提交的工作要求，而 PoFx 會藉由將 PEP_DPM_WORK 通知傳送至 PEP 來回應。

PoFx 會在傳送PEP_DPM_REQUEST_COMPONENT_PERF_STATE通知之前，將要求的 P 狀態變更寫入 PerfRequests 陣列。如果 PEP 以同步方式處理要求的 P 狀態變更， PerfRequests 陣列的內容只會維持有效狀態，直到 AcceptDeviceNotification 回呼例程傳回為止。如果要求 以異步方式完成，則數位內容會維持有效狀態，直到 PEP 呼叫 CompleteWork 例程，以通知 PoFx 已完成擱置的要求。