EVT_WDF_DEVICE_ARM_WAKE_FROM_S0 función de devolución de llamada (wdfdevice.h)
[Se aplica a KMDF y UMDF]
Un controlador EvtDeviceArmWakeFromS0 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 baja potencia, si el sistema permanece en el 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(estado) es igual a TRUE. De lo contrario, debe devolver un valor de estado para el que NT_SUCCESS(estado) 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. (El marco no notifica un error de dispositivo al administrador de PnP).
Observaciones
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.
El EvtDeviceArmWakeFromS0 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 EvtDeviceEnableWakeAtBus función de devolución de llamada 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 EvtDeviceArmWakeFromS0 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 un 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 a la función de devolución de llamada del controlador EvtDeviceArmWakeFromS0.
- 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 PnP y Administración de energía.
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.
Para obtener más información sobre esta función de devolución de llamada, consulte compatibilidad con el apagado inactivo.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| versión mínima de UMDF | 2.0 |
| encabezado de | wdfdevice.h (incluya Wdf.h) |
| irQL | PASSIVE_LEVEL |