通过

POFXCALLBACKUPDATEPLATFORMIDLESTATE 回调函数 （pep_x.h）

  • 项目

UpdatePlatformIdleState 例程由平台扩展插件 （PEP） 调用，以更新指定平台空闲状态的属性。

语法

POFXCALLBACKUPDATEPLATFORMIDLESTATE Pofxcallbackupdateplatformidlestate;

NTSTATUS Pofxcallbackupdateplatformidlestate(
  [in] POHANDLE ProcessorHandle,
  [in] ULONG PlatformState,
  [in] PPEP_PLATFORM_IDLE_STATE_UPDATE Update
)
{...}

参数

[in] ProcessorHandle

一个 POHANDLE 值，表示使用 Windows 电源管理框架（PoFx）注册处理器（作为设备）。 PEP 之前在 PEP_DPM_REGISTER_DEVICE 通知期间从 PoFx 收到此句柄，通知 PEP 处理器已注册到 PoFx。

[in] PlatformState

标识要更新其属性的平台空闲状态的索引。 为了响应以前的 PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES 通知，PEP 指定了受支持的平台空闲状态数。 如果 PEP 指定的 N 平台空闲状态，则有效的平台空闲状态索引范围为 0 到 N-1。 为了响应以前的 PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE 通知，PEP 指定了此平台空闲状态的属性。

[in] Update

指向包含平台空闲状态更新属性的 PEP_PLATFORM_IDLE_STATE_UPDATE 结构的指针。

返回值

UpdatePlatformIdleState 如果成功更新平台空闲状态的属性，则返回STATUS_SUCCESS。 可能的错误返回值包括以下状态代码。

返回值 描述
STATUS_NOT_SUPPORTED
 PEP_PLATFORM_IDLE_STATE_UPDATE 结构中的版本号不是受支持的值。
STATUS_NOT_IMPLEMENTED
 未为此处理器实现 UpdatePlatformIdleState 例程。

言论

此例程由 PoFx 实现，由 PEP 调用。 PEP_KERNEL_INFORMATION_STRUCT_V3 结构的 UpdatePlatformIdleState 成员是指向 UpdatePlatformIdleState 例程的指针。

PEP 必须等到完成所有 PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE 通知后才能调用 UpdatePlatformIdleState 例程。

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

要求

要求 价值
最低支持的客户端 从 Windows 10 开始支持。
目标平台 窗户
标头 pep_x.h （包括 Pep_x.h）
IRQL PASSIVE_LEVEL

另请参阅

PEP_DPM_REGISTER_DEVICE

PEP_KERNEL_INFORMATION_STRUCT_V3

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATE

PEP_NOTIFY_PPM_QUERY_PLATFORM_STATES

PEP_PLATFORM_IDLE_STATE_UPDATE