функция WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT (wdfdevice.h)

Статья
02/07/2025

[Применимо к 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 и задает элемент размера структуры.

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

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

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

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

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

Примеры

Пример кода, использующий WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS_INIT, см. в разделе WdfDeviceAssignS0IdleSettings.

Требования

Требование	Ценность
целевая платформа	Всеобщий
минимальная версия KMDF	1.0
минимальная версия UMDF	2.0
заголовка	wdfdevice.h (include Wdf.h)

См. также

WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS

Поделиться через