EVT_WDF_DEVICE_ARM_WAKE_FROM_SX_WITH_REASON 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 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.
Uno o ambos parámetros pueden ser TRUE, debido a los siguientes escenarios:
  • 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.
Para obtener más información sobre la función de devolución de llamada EvtDeviceArmWakeFromSxWithReason , vea la sección Comentarios de EvtDeviceArmWakeFromSx.

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

Consulte también

EvtDeviceArmWakeFromS0

EvtDeviceArmWakeFromSx

EvtDeviceDisarmWakeFromSx