PEP_NOTIFY_COMPONENT_IDLE_STATE 结构 (pepfx.h)

项目
08/07/2023

PEP_NOTIFY_COMPONENT_IDLE_STATE结构包含有关组件挂起到新 Fx 电源状态转换的状态信息。

语法

typedef struct _PEP_NOTIFY_COMPONENT_IDLE_STATE {
  [in]  PEPHANDLE DeviceHandle;
  [in]  ULONG     Component;
  [in]  ULONG     IdleState;
  [in]  BOOLEAN   DriverNotified;
  [out] BOOLEAN   Completed;
} PEP_NOTIFY_COMPONENT_IDLE_STATE, *PPEP_NOTIFY_COMPONENT_IDLE_STATE;

成员

[in] DeviceHandle

标识设备的 PEPHANDLE 值。 PEP 提供了此句柄，以响应以前的 PEP_DPM_REGISTER_DEVICE 通知。

[in] Component

标识组件的索引。此成员是 PEP 先前为响应此设备的PEP_DPM_REGISTER_DEVICE通知而提供的 PEP_DEVICE_REGISTER_V2 结构中的 Components 数组的索引。如果 Components 数组包含 N 个元素，则组件索引的范围为 0 到 N–1。

[in] IdleState

组件将转换到的新 Fx 电源状态。如果此参数为零，则新状态为 F0;如果此参数为 1，则新状态为 F1;等等。

[in] DriverNotified

设备的驱动程序是否已收到挂起转换到新 Fx 状态的通知。如果为 TRUE，则电源管理框架 (PoFx) 已通过调用驱动程序的 ComponentIdleStateCallback 回调例程通知驱动程序。如果为 FALSE，则 PoFx 尚未通知驱动程序。

[out] Completed

PEP 是否已完成指定组件进入新 Fx 状态的所有必要准备。设置为 TRUE 表示 PEP 已完成所有必要的准备工作，设置为 FALSE 表示尚未完成。

如果为 FALSE，则 PEP 必须在以后完成必要的准备工作，然后在准备完成后通知 PoFx。为此，PEP 调用 RequestWorker 例程来请求工作项，然后通过提交类型为 PepWorkCompleteIdleState 的工作请求来响应随后PEP_DPM_WORK通知，以通知 PoFx 准备工作已完成。