Método IPowerPolicyCallbackWakeFromSx::OnArmWakeFromSx (wudfddi.h)

  • Artículo

[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con 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 con UMDF.

Los brazos de función de devolución de llamada de evento OnArmWakeFromSx de un controlador (es decir, habilita) un dispositivo para que pueda desencadenar una señal de reactivación mientras se encuentra en un estado de dispositivo de bajo consumo. La señal de reactivación hace que el dispositivo entre en su estado de trabajo (D0) y el sistema entra 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 OnArmWakeFromSx 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(status) 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 del controlador. (El marco no notifica un error de dispositivo al administrador de PnP).

Comentarios

El controlador debe proporcionar una función de devolución de llamada OnArmWakeFromSx 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 desencadene 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 una función de devolución de llamada OnArmWakeFromSx , el marco lo llama mientras el dispositivo sigue 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 un IRP de espera/reactivación en nombre del controlador.

El proceso se produce en la secuencia siguiente:

  1. El marco determina que el sistema está a punto de entrar en un estado de sistema de bajo consumo.
  2. El marco llama a la función de devolución de llamada OnArmWakeFromSx del controlador.
  3. El marco solicita al controlador que el bus del dispositivo reduzca la potencia del dispositivo.
Inmediatamente antes de que un dispositivo entre en un estado de baja potencia, el marco llama a la función de devolución de llamada IPnpCallback::OnD0Exit del controlador.

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 energía y PnP 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 del sistema Wake-Up en controladores basados en UMDF.

Requisitos

Requisito Value
Finalización del soporte técnico No disponible en UMDF 2.0 y versiones posteriores.
Plataforma de destino Escritorio
Versión mínima de UMDF 1,9
Encabezado wudfddi.h (incluya Wudfddi.h)

Consulte también

IPowerPolicyCallbackWakeFromSx

IPowerPolicyCallbackWakeFromSx::OnDisarmWakeFromSx

IPowerPolicyCallbackWakeFromSx::OnWakeFromSxTriggered