共用方式為

POFXCALLBACKUPDATEPROCESSORIDLESTATE 回呼函式 (pep_x.h)

  • 發行項

UpdateProcessorIdleState 例程是由平臺擴充功能外掛程式 (PEP) 呼叫，以更新指定處理器閑置狀態的屬性。

語法

POFXCALLBACKUPDATEPROCESSORIDLESTATE Pofxcallbackupdateprocessoridlestate;

NTSTATUS Pofxcallbackupdateprocessoridlestate(
  [in] POHANDLE ProcessorHandle,
  [in] ULONG ProcessorState,
  [in] PPEP_PROCESSOR_IDLE_STATE_UPDATE Update
)
{...}

參數

[in] ProcessorHandle

POHANDLE 值，表示將處理器 (註冊為使用 Windows 電源管理架構 的裝置) ， (PoFx) 。 PEP 先前在通知中通知 PEP 已向 PoFx 註冊處理器的 PEP_DPM_REGISTER_DEVICE 通知期間，從 PoFx 收到此句柄。

[in] ProcessorState

索引，識別要更新其屬性的處理器閑置狀態。 為了回應先前 的PEP_NOTIFY_PPM_QUERY_IDLE_STATES_V2 通知，PEP 指定支援的處理器閑置狀態數目和這些狀態的屬性。 如果 PEP 指定的 N 處理器閒置狀態，有效的處理器閒置狀態索引範圍從 0 到 N-1。

[in] Update

包含處理器閑置狀態更新屬性 之PEP_PROCESSOR_IDLE_STATE_UPDATE 結構的指標。

傳回值

如果 UpdateProcessorIdleState 成功更新處理器閑置狀態的屬性，則會傳回STATUS_SUCCESS。 可能的錯誤傳回值包括下列狀態代碼。

傳回值 描述
STATUS_NOT_SUPPORTED
 PEP_PROCESSOR_IDLE_STATE_UPDATE結構中的版本號碼不是支援的值。
STATUS_NOT_IMPLEMENTED
 此處理器未實作 UpdateProcessorIdleState 例程。

備註

此例程是由 PoFx 所實作，並由 PEP 呼叫。 PEP_KERNEL_INFORMATION_STRUCT_V3 結構的 UpdateProcessorIdleState 成員是 UpdateProcessorIdleState 例程的指標。

UpdateProcessorIdleState 例程必須在 IRQL = PASSIVE_LEVEL呼叫。

規格需求

需求 值
最低支援的用戶端 從Windows 10 開始支援。
目標平台 Windows
標頭 pep_x.h (包含 Pep_x.h)
IRQL PASSIVE_LEVEL

另請參閱

PEP_DPM_REGISTER_DEVICE

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_PROCESSOR_IDLE_STATE_UPDATE