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

  • Статья

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

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

Синтаксис

EVT_WDF_DEVICE_WAKE_FROM_S0_TRIGGERED EvtWdfDeviceWakeFromS0Triggered;

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

Параметры

[in] Device

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

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

None

Remarks

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

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

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

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

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

Требования

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

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

EvtDeviceArmWakeFromS0

EvtDeviceDisarmWakeFromS0

EvtDeviceWakeFromSxTriggered