POFXCALLBACKUPDATEPROCESSORIDLESTATE 回调函数 (pep_x.h)

  • 项目

平台扩展插件 (PEP) 调用 UpdateProcessorIdleState 例程，以更新指定处理器空闲状态的属性。

语法

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 例程的指针。

必须在 IRQL = PASSIVE_LEVEL 调用 UpdateProcessorIdleState 例程。

要求

要求 值
最低受支持的客户端 从 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