WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT 函数 (wdfdevice.h)
[适用于 KMDF 和 UMDF]
WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT 函数初始化驱动程序的WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS结构。
语法
void WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT(
[out] PWDF_DEVICE_POWER_POLICY_IDLE_SETTINGS Settings,
[in] WDF_POWER_POLICY_S0_IDLE_CAPABILITIES IdleCaps
);
参数
[out] Settings
指向驱动程序分配 的WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS 结构的指针。
[in] IdleCaps
WDF_POWER_POLICY_S0_IDLE_CAPABILITIES类型的枚举器。
返回值
无
备注
首先， WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT 函数将指定的 WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS 结构归零，并设置结构的 Size 成员。
然后，函数将结构的 IdleTimeout 成员设置为 IdleTimeoutDefaultValue，将 UserControlOfIdleSettings 成员设置为 IdleAllowUserControl，并将 Enabled 成员设置为 WdfUseDefault。
此外，函数将 PowerUpIdleDeviceOnSystemWake 成员设置为 WdfUseDefault ， 将 IdleTimeoutType 成员设置为 DriverManagedIdleTimeout。
此外，函数将 ExcludeD3Cold 成员设置为 WdfUseDefault。
接下来，函数将结构的 IdleCaps 成员设置为 IdleCaps 参数指定的值。
最后，如果 IdleCaps 参数指定 IdleUsbSelectiveSuspend 或 IdleCanWakeFromS0，则函数将 DxState 成员设置为 PowerDeviceMaximum。 如果 IdleCaps 参数指定 IdleCannotWakeFromS0，则函数将 DxState 成员设置为 PowerDeviceD3。
示例
有关使用 WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT 的代码示例，请参阅 WdfDeviceAssignS0IdleSettings。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 通用 |
| 最低 KMDF 版本 | 1.0 |
| 最低 UMDF 版本 | 2.0 |
| 标头 | wdfdevice.h (包括 Wdf.h) |