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 结构为零，并设置结构的 大小 成员。

然后，该函数将结构的 IdleTimeout 成员设置为 IdleTimeoutDefaultValue，将 UserControlOfIdleSettings 成员设置为 IdleAllowUserControl，并将已启用 成员 设置为 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。

要求

另请参阅

IWDFDevice3：：AssignS0IdleSettingsEx

WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS