EVT_WDF_DEVICE_ARM_WAKE_FROM_SX_WITH_REASON función de devolución de llamada (wdfdevice.h)
[Se aplica a KMDF y UMDF]
Los brazos de función de devolución de llamada de evento EvtDeviceArmWakeFromSxWithReason de un controlador (es decir, habilitan) 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 hace que el sistema entre en su estado de trabajo (S0).
Sintaxis
EVT_WDF_DEVICE_ARM_WAKE_FROM_SX_WITH_REASON EvtWdfDeviceArmWakeFromSxWithReason;
NTSTATUS EvtWdfDeviceArmWakeFromSxWithReason(
[in] WDFDEVICE Device,
[in] BOOLEAN DeviceWakeEnabled,
[in] BOOLEAN ChildrenArmedForWake
)
{...}
Parámetros
[in] Device
Identificador de un objeto de dispositivo de marco.
[in] DeviceWakeEnabled
Valor booleano que, si es TRUE, indica que la capacidad del dispositivo para reactivar el sistema está habilitada.
[in] ChildrenArmedForWake
Valor booleano que, si es TRUE, indica que la capacidad de uno o varios dispositivos secundarios para reactivar el sistema está habilitado.
Valor devuelto
Si la función de devolución de llamada EvtDeviceArmWakeFromSxWithReason no encuentra ningún error, debe devolver STATUS_SUCCESS u otro valor de estado para el que NT_SUCCESS(status) sea igual a 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 llama a la función de devolución de llamada EvtDeviceDisarmWakeFromSx del controlador. (El marco no notifica un error de dispositivo al administrador de PnP).
Comentarios
La versión 1.7 y versiones posteriores de KMDF admiten la función de devolución de llamada EvtDeviceArmWakeFromSxWithReason además de la función de devolución de llamada EvtDeviceArkeFromSx .
Para registrar una función de devolución de llamada EvtDeviceArmWakeFromSxWithReason , un controlador debe llamar a WdfDeviceInitSetPowerPolicyEventCallbacks. Los controladores pueden registrar una función de devolución de llamada EvtDeviceArmWakeFromSx o una función de devolución de llamada EvtDeviceArmWakeFromSxWithReason , pero no ambas.
La función de devolución de llamada EvtDeviceArmWakeFromSxWithReason proporciona dos parámetros que permiten al controlador determinar por qué el marco lo ha llamado:
- El marco establece el parámetro DeviceWakeEnabled en TRUE si el miembro Enabled de la estructura WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS indica que el dispositivo puede reactivar el sistema.
- El marco establece el parámetro ChildrenArmedForWake en TRUE si uno o varios de los dispositivos secundarios del dispositivo pueden reactivar el sistema y el miembro ArmForWakeIfChildrenAreArmedForWake de WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS está establecido en TRUE.
- El dispositivo del controlador está habilitado para reactivar el sistema.
- Uno o varios de los dispositivos secundarios del dispositivo están habilitados para reactivar el sistema.
- Tanto el dispositivo como uno o varios de sus dispositivos secundarios están habilitados para reactivar el sistema.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.7 |
| Versión mínima de UMDF | 2.0 |
| Encabezado | wdfdevice.h (incluir Wdf.h) |
| IRQL | PASSIVE_LEVEL |