функция 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типа.

Возвращаемое значение

Никакой

Замечания

Во-первых, функция WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT ноль указанной структуры WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS и задает элемент размера структуры.

Затем функция задает элемент IdleTimeoutIdleTimeoutDefaultValue, задает элемент UserControlOfIdleSettings IdleAllowUserControlи задает элемент включено WdfUseDefault.

Кроме того, функция задает элемент PowerUpIdleDeviceOnSystemWake для WdfUseDefault.

Затем функция задает элемент ExcludeD3Cold для WdfUseDefault.

Затем функция задает элемент IdleCaps структуры значением, которое указывает параметр IdleCaps.

Наконец, если параметр IdleCaps указывает IdleUsbSelectiveSelectiveSuspend или IdleCanWakeFromS0, функция задает элемент DxState PowerDeviceMaximum. Если параметр IdleCaps указывает IdleCannotWakeFromS0, функция задает элемент DxStatePowerDeviceD3.

Пример кода, использующий WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT, см. в разделе IWDFDevice3::AssignS0IdleSettingsEx.

Требования

См. также

IWDFDevice3::AssignS0IdleSettingsEx

WUDF_DEVICE_POWER_POLICY_IDLE_SETTINGS