Функция WdfDeviceAssignSxWakeSettings (wdfdevice.h)

Статья
02/07/2025

[Применимо к KMDF и UMDF]

Метод WdfDeviceAssignSxWakeSettings предоставляет сведения о способности устройства активировать сигнал пробуждения, пока устройство и система находятся в состоянии низкой мощности.

Синтаксис

NTSTATUS WdfDeviceAssignSxWakeSettings(
  [in] WDFDEVICE                              Device,
  [in] PWDF_DEVICE_POWER_POLICY_WAKE_SETTINGS Settings
);

Параметры

[in] Device

Дескриптор объекта устройства платформы.

[in] Settings

Указатель на структуру, предоставляемую вызывающим WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS.

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

Если операция выполнена успешно, WdfDeviceAssignSxWakeSettings возвращает STATUS_SUCCESS. К дополнительным возвращаемым значениям относятся:

Возвращаемый код	Описание
STATUS_INVALID_DEVICE_REQUEST	Вызывающий драйвер не является владельцем политики питания устройства.
STATUS_INVALID_PARAMETER	Обнаружено недопустимое значение параметра .
STATUS_INFO_LENGTH_MISMATCH	Неправильный размер структуры WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS.
STATUS_POWER_STATE_INVALID	Драйвер шины указывает, что устройство не может активировать сигнал пробуждения, или структура WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS содержит недопустимое состояние питания устройства.

Метод может возвращать другие значения NTSTATUS.

Ошибка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Замечания

Дополнительные сведения см. в поддержкепробуждения системы.

Примеры

Следующий пример кода инициализирует структуру WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS, а затем вызывает WdfDeviceAssignSxWakeSettings. В примере используются параметры по умолчанию, которые WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS_INIT наборов.

WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS  wakeSettings;
NTSTATUS  status = STATUS_SUCCESS;

WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS_INIT(&wakeSettings);

status = WdfDeviceAssignSxWakeSettings(
                                       device,
                                       &wakeSettings
                                       );
if (!NT_SUCCESS(status)) {
    return status;
}

Требования

Требование	Ценность
целевая платформа	Всеобщий
минимальная версия KMDF	1.0
минимальная версия UMDF	2.0
заголовка	wdfdevice.h (include Wdf.h)
библиотеки	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
правил соответствия DDI	DriverCreate(kmdf), FDOPowerPolicyOwnerAPI(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), NonFDONotPowerPolicyOwnerAPI(kmdf)

См. также

WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS

WdfDeviceAssignS0IdleSettings

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