Метод IPowerPolicyCallbackWakeFromSx::OnArmWakeFromSx (wudfddi.h)
[Предупреждение: 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 о сбое устройства.)
Комментарии
Драйвер должен предоставить функцию обратного вызова OnArmWakeFromSx , если драйвер поддерживает интерфейс IPowerPolicyCallbackWakeFromSx .
Эта функция обратного вызова обрабатывает операции, связанные с устройством, которые необходимы для обнаружения внешнего события, которое активирует сигнал пробуждения в шине. Драйвер шины в режиме ядра обрабатывает определенные для шины операции, такие как включение сигнала события управления питанием (PME) шины PCI.
Если драйвер зарегистрировал функцию обратного вызова OnArmWakeFromSx , платформа вызывает ее, пока устройство все еще находится в состоянии питания устройства D0, прежде чем драйвер шины понижает состояние питания устройства, но после того, как платформа отправила IRP ожидания или пробуждения от имени драйвера.
Процесс выполняется в следующей последовательности:
- Платформа определяет, что система вот-вот перейдет в состояние системы с низким энергопотреблением.
- Платформа вызывает функцию обратного вызова OnArmWakeFromSx драйвера.
- Платформа запрашивает у водителя шину устройства, чтобы снизить мощность устройства.
Дополнительные сведения о том, когда платформа вызывает эту функцию обратного вызова, см. в разделе Сценарии PnP и управления питанием в UMDF.
Вам не нужно предоставлять функцию обратного вызова OnArmWakeFromSx , если для устройства не требуются специальные аппаратные операции, позволяющие устройству активировать сигнал пробуждения.
Дополнительные сведения об этой функции обратного вызова см. в разделе Поддержка системных Wake-Up в драйверах на основе UMDF.
Требования
| Требование | Значение |
|---|---|
| Дата окончания поддержки | Недоступно в UMDF 2.0 и более поздних версиях. |
| Целевая платформа | Персональный компьютер |
| Минимальная версия UMDF | 1,9 |
| Верхняя часть | wudfddi.h (включая Wudfddi.h) |
См. также раздел
IPowerPolicyCallbackWakeFromSx