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 |