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

Статья
02/29/2024

[Применимо к 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 типизированный перечислитель.

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

None

Remarks

Во-первых, функция 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.

Требования

Требование	Значение
Целевая платформа	Универсальное
Минимальная версия KMDF	1,0
Минимальная версия UMDF	2,0
Верхняя часть	wdfdevice.h (включая Wdf.h)

См. также раздел

WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS

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