共用方式為

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)

另請參閱

WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS