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。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 最小 KMDF 版本 | 1.0 |
| 最低UMDF版本 | 2.0 |
| 標頭 | wdfdevice.h (包含 Wdf.h) |