Метод IPowerPolicyCallbackWakeFromSx::OnArmWakeFromSx (wudfddi.h)

Статья
08/08/2023

[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с помощью UMDF.]

Функция обратного вызова события OnArmWakeFromSx драйвера (т. е. включает) устройство, которое может активировать сигнал пробуждения, находясь в состоянии устройства с низким энергопотреблением. Сигнал пробуждения приводит к тому, что устройство переходит в рабочее состояние (D0), а система — в рабочее состояние (S0).

Синтаксис

HRESULT OnArmWakeFromSx(
  [in] IWDFDevice *pWdfDevice
);

Параметры

[in] pWdfDevice

Указатель на интерфейс IWDFDevice объекта устройства, представляющего одно из устройств драйвера.

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

Если операция выполнена успешно, функция обратного вызова OnArmWakeFromSx должна возвращать S_OK или другое значение состояния, для которого SUCCEEDED(status) равно TRUE. В противном случае он должен вернуть значение состояния, для которого SUCCEEDED(status) равно FALSE.

Если значение SUCCEEDED(status) равно FALSE, платформа вызывает функцию обратного вызова IPowerPolicyCallbackWakeFromSx::OnDisarmWakeFromSx драйвера. (Платформа не сообщает диспетчеру PnP о сбое устройства.)

Эта функция обратного вызова обрабатывает операции, связанные с устройством, которые необходимы для обнаружения внешнего события, которое активирует сигнал пробуждения в шине. Драйвер шины в режиме ядра обрабатывает определенные для шины операции, такие как включение сигнала события управления питанием (PME) шины PCI.

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

Процесс выполняется в следующей последовательности:

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

Непосредственно перед переходом устройства в состояние низкого энергопотребления платформа вызывает функцию обратного вызова IPnpCallback::OnD0Exit драйвера.

Дополнительные сведения о том, когда платформа вызывает эту функцию обратного вызова, см. в разделе Сценарии PnP и управления питанием в UMDF.

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

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

Требования

Требование	Значение
Дата окончания поддержки	Недоступно в UMDF 2.0 и более поздних версиях.
Целевая платформа	Персональный компьютер
Минимальная версия UMDF	1,9
Верхняя часть	wudfddi.h (включая Wudfddi.h)

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

IPowerPolicyCallbackWakeFromSx

IPowerPolicyCallbackWakeFromSx::OnDisarmWakeFromSx

IPowerPolicyCallbackWakeFromSx::OnWakeFromSxTriggered