PoFxSetComponentWake 函数 (wdm.h)

PoFxSetComponentWake 例程指示驱动程序是否在组件进入空闲条件时支持指定的组件进行唤醒。

语法

void PoFxSetComponentWake(
  [in] POHANDLE Handle,
  [in] ULONG    Component,
  [in] BOOLEAN  WakeHint
);

[in] Handle

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

[in] Component

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

[in] WakeHint

每当组件进入空闲状态时，驱动程序是否支持组件唤醒。如果为 TRUE，则驱动程序支持组件唤醒。如果为 FALSE，则驱动程序不会将组件武装到唤醒。

无

在组件进入低功耗 Fx 状态之前，驱动程序可能会使组件自动唤醒，以响应来自外部源 (的输入信号，例如，如果用户按下按钮) 。 WakeHint 参数通知 PoFx 驱动程序是否支持组件唤醒。如果组件已准备好唤醒，则 PoFx 不会将该组件切换到组件无法从中唤醒的低功率 Fx 状态。

向 PoFx 注册设备时，设备中每个组件的注册信息包含在单独的 PO_FX_COMPONENT 结构中。此结构的 DeepestWakeableIdleState 成员指定组件可从中唤醒的最深 Fx 状态。

每次条件更改需要 WakeHint 值更改时，设备驱动程序都可以调用 PoFxSetComponentWake。每次调用后，新的 WakeHint 值将一直有效，直到驱动程序再次调用 PoFxSetComponentWake 来更新它。

如果在调用 PoFxSetComponentWake 时组件处于空闲状态，则 PoFx 可能会更改组件的 Fx 状态，以适应调用方指定的新 WakeHint 参数值。