EVT_WDF_DEVICE_ARM_WAKE_FROM_SX_WITH_REASON función de devolución de llamada (wdfdevice.h)
[Se aplica a KMDF y UMDF]
Un controlador EvtDeviceArmWakeFromSxWithReason los brazos de función de devolución de llamada de eventos (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 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 TRUE, indica que la capacidad del dispositivo para reactivar el sistema está habilitada.
[in] ChildrenArmedForWake
Valor booleano que, si 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(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(estado) es igual a FALSE, el marco llama a la función de devolución de llamada evtDeviceDisarmWakeFromSx. (El marco no notifica un error de dispositivo al administrador de PnP).
Observaciones
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 EvtDeviceArmWakeFromSx.
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 función de devolución de llamada, pero no ambas.
La función de devolución de llamada EvtDeviceArmWakeFromSxWithReas on 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 Habilitado 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 ArmForWakeIfChildrenAreArmedForWake miembro de WDF_DEVICE_POWER_POLICY_WAKE_SETTINGS se establece 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 | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.7 |
| versión mínima de UMDF | 2.0 |
| encabezado de | wdfdevice.h (incluya Wdf.h) |
| irQL | PASSIVE_LEVEL |