通过

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_DPM_REGISTER_DEVICE 通知期间从 PoFx 收到此句柄，通知 PEP 处理器已注册到 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 开始支持。
目标平台 窗户
标头 pep_x.h （包括 Pep_x.h）
IRQL PASSIVE_LEVEL

另请参阅

PEP_DPM_REGISTER_DEVICE

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_PROCESSOR_IDLE_STATE_UPDATE