EVT_WDF_DEVICE_ARM_WAKE_FROM_S0 función de devolución de llamada (wdfdevice.h)

  • Artículo

[Se aplica a KMDF y UMDF]

Los brazos de función de devolución de llamada de evento EvtDeviceArmWakeFromS0 de un controlador (es decir, habilita) un dispositivo para que pueda desencadenar una señal de reactivación mientras está en estado de dispositivo de bajo consumo, si el sistema permanece en estado de funcionamiento del sistema (S0).

Sintaxis

EVT_WDF_DEVICE_ARM_WAKE_FROM_S0 EvtWdfDeviceArmWakeFromS0;

NTSTATUS EvtWdfDeviceArmWakeFromS0(
  [in] WDFDEVICE Device
)
{...}

Parámetros

[in] Device

Identificador de un objeto de dispositivo de marco.

Valor devuelto

Si la operación se realiza correctamente, la función de devolución de llamada EvtDeviceArmWakeFromS0 debe devolver STATUS_SUCCESS u otro valor de estado para el que NT_SUCCESS(status) sea TRUE. De lo contrario, debe devolver un valor de estado para el que NT_SUCCESS(status) es igual a FALSE.

Si NT_SUCCESS(status) es igual a FALSE, el marco no llama a la función de devolución de llamada EvtDeviceDisarmWakeFromS0 del controlador. (El marco no notifica un error de dispositivo al administrador de PnP).

Comentarios

Para registrar una función de devolución de llamada EvtDeviceArmWakeFromS0 , un controlador debe llamar a WdfDeviceInitSetPowerPolicyEventCallbacks. Además, el controlador debe establecer IdleCanWakeFromS0 en el miembro IdleCaps de su estructura de WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS .

La función de devolución de llamada EvtDeviceArmWakeFromS0 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. La función de devolución de llamada EvtDeviceEnableWakeAtBus del controlador de autobús 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 una función de devolución de llamada EvtDeviceArmWakeFromS0 , 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 alimentación 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 dispositivo ha estado inactivo durante un período de tiempo preestablecido.
  2. El marco llama a la función de devolución de llamada EvtDeviceArmWakeFromS0 del controlador.
  3. El marco solicita al controlador que el bus del dispositivo reduzca la potencia del dispositivo.
Inmediatamente antes de que el dispositivo entre en un estado de bajo consumo, el marco llamará a la función de devolución de llamada EvtDeviceD0Exit 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.

No es necesario proporcionar una función de devolución de llamada EvtDeviceArmWakeFromS0 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.
Si el dispositivo admite la "suspensión selectiva" USB y si el controlador establece IdleUsbSelectiveSuspend en el miembro IdleCaps de su estructura de WDF_DEVICE_POWER_POLICY_IDLE_SETTINGS , el marco envía una solicitud de "suspensión selectiva" al controlador de bus USB cuando el dispositivo ha estado inactivo durante un período de tiempo preestablecido.

Para obtener más información sobre esta función de devolución de llamada, consulte Compatibilidad con el apagado inactivo.

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Versión mínima de UMDF 2.0
Encabezado wdfdevice.h (incluya Wdf.h)
IRQL PASSIVE_LEVEL

Consulte también

EvtDeviceArmWakeFromSx

EvtDeviceDisarmWakeFromS0