POFXCALLBACKUPDATEPLATFORMIDLESTATE 回调函数 (pepfx.h)

项目
08/07/2023

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 已向 PoFx 注册处理器的 PEP_DPM_REGISTER_DEVICE 通知中收到来自 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 例程。