WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT 函数 (wudfdevice.h)
[警告： UMDF 2 是最新版本的 UMDF，并取代 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 不会向 UMDF 1 添加任何新功能，并且较新版本的 Windows 10 上对 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息，请参阅使用 UMDF 入门。]
WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT 函数初始化驱动程序的 WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS 结构。
语法
void WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT(
[out] PWUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS Settings,
[in] WDF_POWER_POLICY_S0_IDLE_CAPABILITIES IdleCaps
);
参数
[out] Settings
指向驱动程序分配 的WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS 结构的指针。
[in] IdleCaps
WDF_POWER_POLICY_S0_IDLE_CAPABILITIES类型的枚举器。
返回值
无
备注
首先， WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT 函数将指定的 WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS 结构归零，并设置结构的 Size 成员。
然后，函数将结构的 IdleTimeout 成员设置为 IdleTimeoutDefaultValue，将 UserControlOfIdleSettings 成员设置为 IdleAllowUserControl，并将 Enabled 成员设置为 WdfUseDefault。
此外，函数将 PowerUpIdleDeviceOnSystemWake 成员设置为 WdfUseDefault。
然后，函数将 ExcludeD3Cold 成员设置为 WdfUseDefault。
接下来，函数将结构的 IdleCaps 成员设置为 IdleCaps 参数指定的值。
最后，如果 IdleCaps 参数指定 IdleUsbSelectiveSuspend 或 IdleCanWakeFromS0，则函数将 DxState 成员设置为 PowerDeviceMaximum。 如果 IdleCaps 参数指定 IdleCannotWakeFromS0，则函数将 DxState 成员设置为 PowerDeviceD3。
有关使用 WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT 的代码示例，请参阅 IWDFDevice3：：AssignS0IdleSettingsEx。
要求
| 要求 | 值 |
|---|---|
| 结束支持 | 在 UMDF 2.0 及更高版本中不可用。 |
| 目标平台 | 桌面 |
| 最低 UMDF 版本 | 1.11 |
| 标头 | wudfdevice.h |