支持多组件设备空闲时关闭电源

[仅适用于 KMDF]

多组件设备的 KMDF 驱动程序可以支持 空闲关闭 电源和功能电源状态。 由于在这种情况下，驱动程序直接注册到电源管理框架 (PoFx) ，因此驱动程序必须与 PoFx 协调生成的 Dx 状态更改。

提供设备电源策略空闲设置

调用 WdfDeviceAssignS0IdleSettings 时，驱动程序必须在WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS结构中将 IdleTimeoutType 设置为 DriverManagedIdleTimeout。 此外，驱动程序必须将 PowerUpIdleDeviceOnSystemWake 设置为 WdfTrue， 并将 IdleCaps 设置为 IdleCannotWakeFromS0，如以下示例所示。

WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS s0IdleSettings;

WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT(&s0IdleSettings, 
                                           IdleCannotWakeFromS0);
s0IdleSettings.IdleTimeoutType = DriverManagedIdleTimeout;
s0IdleSettings.PowerUpIdleDeviceOnSystemWake = WdfTrue;
s0IdleSettings.IdleTimeout = 1;
status = WdfDeviceAssignS0IdleSettings(device, &s0IdleSettings);

从 Working (D0) 转换为 Low-Power (Dx) 状态

在 EvtDeviceSelfManagedIoInit 中，驱动程序调用 WdfDeviceStopIdle 来获取电源参考，从而阻止 WDF 将设备置于低功耗状态。

驱动程序通过从其 DevicePowerRequiredCallback 回调例程调用 WdfDeviceResumeIdle 来释放电源引用。

驱动程序通常指定非常短的空闲超时，以便 WDF 在所有电源参考释放后不久将设备置于低功耗状态。

从 Low-Power (Dx) 转换为工作状态 (D0) 状态

在 DevicePowerRequiredCallback 中，驱动程序必须将设备置于其工作 (D0) 状态。 为此，它必须遵循对 WdfDeviceStopIdle 的调用，并将 WaitForD0 参数设置为 TRUE。 对 WdfDeviceStopIdle 的阻止调用不得从 DevicePowerRequiredCallback中进行。

相反，驱动程序必须延迟对在被动级别运行的工作线程的阻塞调用，并保证不会在电源管理的队列的 I/O 调度例程的上下文中进行 WdfDeviceStopIdle 调用。

如果驱动程序之前已调用 WdfDeviceInitSetPowerPageable (这意味着它可以在电源转换期间访问可分页数据) ，则驱动程序可以调用 WdfWorkItemCreate 来创建框架工作项。 如果驱动程序尚未设置 power-pageable，则驱动程序必须创建自己的系统线程。 有关详细信息，请参阅 PsCreateSystemThread。

WdfDeviceStopIdle 返回后，即使该方法返回错误，驱动程序也必须调用 PoFxReportDevicePoweredOn。