Método IPowerPolicyCallbackWakeFromSx::OnArmWakeFromSx (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 OnArmWakeFromSx los brazos de función de devolución de llamada de evento (es decir, habilita) un dispositivo para que pueda desencadenar una señal de reactivación mientras está en estado de dispositivo de bajo consumo. La señal de reactivación hace que el dispositivo entre su estado de trabajo (D0) y el sistema entren en su estado de trabajo (S0).
Sintaxis
HRESULT OnArmWakeFromSx(
[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 OnArmWakeFromS x 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 IPowerPolicyCallbackWakeFromSx::OnDisarmWakeFromSx. (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 x si el controlador admite la interfaz IPowerPolicyCallbackWakeFromSx.
Esta 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 un controlador ha registrado un OnArmWakeFromSx 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 sistema está a punto de entrar en un estado de sistema de baja potencia.
- El marco llama a la onArmWakeFromSx del controlador función de devolución de llamada.
- El marco pide 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 OnArmWakeFromSx si el dispositivo 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 el sistema Wake-Up 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
IPowerPolicyCallbackWakeFromSx