Método IPowerPolicyCallbackWakeFromS0::OnArmWakeFromS0 (wudfddi.h)
[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los nuevos controladores UMDF deben escribirse mediante UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción a UMDF.]
Un controlador OnArmWakeFromS0 brazos de función de devolución de llamada (es decir, habilita) un dispositivo para que pueda desencadenar una señal de reactivación mientras está en estado de dispositivo de baja potencia, si el sistema permanece en el estado de funcionamiento del sistema (S0).
Sintaxis
HRESULT OnArmWakeFromS0(
[in] IWDFDevice *pWdfDevice
);
Parámetros
[in] pWdfDevice
Puntero a la interfaz IWDFDevice del objeto de dispositivo que representa uno de los dispositivos del controlador.
Valor devuelto
Si la operación se realiza correctamente, la función de devolución de llamada OnArmWakeFromS0 debe devolver S_OK u otro valor de estado para el que SUCCEEDED(status) es igual a TRUE. De lo contrario, debe devolver un valor de estado para el que SUCCEEDED(estado) es igual a FALSE.
Si SUCCEEDED(status) es igual a FALSE, el marco llama a la función de devolución de llamada IPowerPolicyCallbackWakeFromS0::OnDisarmWakeFromS0. (El marco no notifica un error de dispositivo al administrador de PnP).
Observaciones
El controlador debe proporcionar una función de devolución de llamada OnArmWakeFromS 0 si el controlador admite la interfaz IPowerPolicyCallbackWakeFromS0.
El OnArmWakeFromS0 función de devolución de llamada controla las operaciones específicas del dispositivo necesarias para permitir que el dispositivo detecte un evento externo que desencadena una señal de reactivación en el bus. El controlador de bus en modo kernel controla las operaciones específicas del bus, como habilitar la señal del evento de administración de energía (PME) del bus PCI.
Si el controlador ha registrado un OnArmWakeFromS0 función de devolución de llamada, el marco lo llama mientras el dispositivo todavía está en estado de alimentación del dispositivo D0, antes de que el controlador de bus reduzca el estado de energía del dispositivo, pero después de que el marco haya enviado una IRP de espera/reactivación en nombre del controlador.
El proceso se produce en la siguiente secuencia:
- El marco determina que el dispositivo ha estado inactivo durante un período de tiempo preestablecido.
- El marco llama al onArmWakeFromS0 del controlador función de devolución de llamada.
- El marco solicita al controlador que el bus del dispositivo reduzca la potencia del dispositivo.
Para obtener más información sobre cuándo el marco llama a esta función de devolución de llamada, consulte escenarios de administración de PnP y Power Management en UMDF.
No es necesario proporcionar una función de devolución de llamada OnArmWakeFromS 0 si el dispositivo:
- Es un dispositivo USB que admite "suspensión selectiva".
- No se puede apagar mientras el sistema permanece totalmente encendido.
- No requiere operaciones de hardware especiales que permitan al dispositivo desencadenar una señal de reactivación.
Para obtener más información sobre esta función de devolución de llamada, consulte compatibilidad con Power-Down inactivos en controladores basados en UMDF.
Requisitos
| Requisito | Valor |
|---|---|
| fin del soporte técnico | No disponible en UMDF 2.0 y versiones posteriores. |
| de la plataforma de destino de | Escritorio |
| versión mínima de UMDF | 1.9 |
| encabezado de | wudfddi.h (incluya Wudfddi.h) |
Consulte también
IPowerPolicyCallbackWakeFromS0