Функция WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT (wudfdevice.h)
[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы 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 типизированный перечислитель.
Возвращаемое значение
None
Remarks
Во-первых, функция 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 |