функция обратного вызова EVT_WDF_DEVICE_WAKE_FROM_SX_TRIGGERED (wdfdevice.h)

  • Статья

[Относится к KMDF и UMDF]

Функция обратного вызова события EvtDeviceWakeFromSxTriggered сообщает драйверу, что его устройство, которое ранее перешло в состояние устройства с низким энергопотреблением из-за снижения уровня питания системы, могло активировать сигнал пробуждения.

Синтаксис

EVT_WDF_DEVICE_WAKE_FROM_SX_TRIGGERED EvtWdfDeviceWakeFromSxTriggered;

void EvtWdfDeviceWakeFromSxTriggered(
  [in] WDFDEVICE Device
)
{...}

Параметры

[in] Device

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

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

None

Remarks

Чтобы зарегистрировать функцию обратного вызова EvtDeviceWakeFromSxTriggered , драйвер должен вызвать WdfDeviceInitSetPowerPolicyEventCallbacks.

Если драйвер зарегистрировал этот обратный вызов, платформа вызывает его после вызова функции обратного вызова EvtDeviceD0Entry драйвера и перед вызовом функции обратного вызова EvtDeviceDisarmWakeFromSx драйвера.

Системное оборудование (БИОС, системные платы, адаптеры автобуса) иногда может сбрасывать сигнал пробуждения до того, как водитель автобуса обнаружит его, даже если сигнал пробуждает систему. В таких случаях функция обратного вызова EvtDeviceWakeFromSxTriggered драйвера не будет вызываться, даже если устройство драйвера активировало сигнал пробуждения.

Некоторые автобусы объединяют сигналы пробуждения от нескольких детей. Если устройство подключено к одной из этих шин, функция обратного вызова может определить, активировало ли текущее устройство сигнал пробуждения. Если устройство предоставляет аппаратную блокировку, которая сохраняет активированное состояние устройства, лучше всего проверка это состояние в функции обратного вызова EvtDeviceDisarmWakeFromSx драйвера, так как этот обратный вызов всегда вызывается после пробуждения устройства, даже если сигнал пробуждения был удален.

Дополнительные сведения об этой функции обратного вызова см. в разделе Поддержка пробуждения системы.

Требования

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

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

EvtDeviceArmWakeFromSx

EvtDeviceDisarmWakeFromSx

EvtDeviceWakeFromS0Triggered