poFxSetComponentResidency 函数 (wdm.h)

PoFxSetComponentResidency 例程设置组件进入空闲条件后组件可能保持空闲状态的估计时间。

语法

void PoFxSetComponentResidency(
  [in] POHANDLE  Handle,
  [in] ULONG     Component,
  [in] ULONGLONG Residency
);

[in] Handle

表示设备注册到电源管理框架 (PoFx) 的句柄。设备驱动程序以前从 PoFxRegisterDevice 例程收到此句柄。

[in] Component

标识组件的索引。此参数是设备驱动程序用于将设备注册到 PoFx 的 PO_FX_DEVICE 结构中的 Components 数组的索引。如果 Components 数组包含 N 个元素，则组件索引的范围为 0 到 N–1。

[in] Residency

估计的驻留时间，以 100 纳秒为单位。此参数是 PoFx 的提示，说明组件在从活动条件转换到空闲条件后可能保持空闲的时间。有关详细信息，请参阅“备注”。

无

调用驱动程序提供 PoFx 可以用作提高性能的提示的估计驻留时间。 PoFx 使用此提示为处于空闲状态的组件选择适当的低功耗 Fx 状态。

每次环境更改需要更改预计驻留时间时，设备驱动程序都可以调用 PoFxSetComponentResidency 。每次调用后，新的估计驻留时间一直有效，直到驱动程序再次调用 PoFxSetComponentResidency 来更新它。

如果在调用 PoFxSetComponentResidency 时组件处于空闲状态，则 PoFx 可能会更改组件的 Fx 状态，以适应调用方指定的新估计驻留时间。