Compartir a través de

EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE función de devolución de llamada (netdevice.h)

  • Artículo

Implemente esta devolución de llamada opcional para rechazar los patrones de reactivación que no son compatibles con el hardware.

Sintaxis

EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE EvtNetDevicePreviewWakeSource;

NTSTATUS EvtNetDevicePreviewWakeSource(
  [_In_] WDFDEVICE Device,
  [_In_] NETWAKESOURCE WakeSource
)
{...}

Parámetros

[_In_] Device

Objeto WDFDEVICE que el controlador cliente obtuvo anteriormente con una llamada a WdfDeviceCreate.

[_In_] WakeSource

Objeto NETWAKESOURCE que representa el origen de reactivación que se va a examinar.

Valor devuelto

Para aceptar el patrón, la función de devolución de llamada debe devolver STATUS_SUCCESS.

Para rechazar el patrón, devuelva STATUS_NDIS_PM_WOL_PATTERN_LIST_FULL.

Comentarios

Los controladores no son necesarios para implementar EvtNetDevicePreviewWakeSource, ya que NetAdapterCx ya bloquea los orígenes de reactivación que no son compatibles con el NET_ADAPTER_WAKE_BITMAP_CAPABILITIES del controlador. Sin embargo, si el hardware tiene limitaciones adicionales que no se pueden expresar en la estructura de funcionalidades de mapa de bits, puede proporcionar EvtNetDevicePreviewWakeSource para aplicar esas limitaciones adicionales.

Registre la implementación de esta función de devolución de llamada estableciendo el miembro adecuado del NET_DEVICE_POWER_POLICY_EVENT_CALLBACKS y, a continuación, llamando a NetDeviceInitSetPowerPolicyEventCallbacks.

Los controladores de cliente suelen llamar a NetDeviceInitSetPowerPolicyEventCallbacks al crear el objeto de dispositivo antes de llamar a WdfDeviceCreate.

En esta devolución de llamada, los controladores de cliente obtienen la oportunidad de rechazar el origen de reactivación. Por ejemplo, si el número de filtros de energía de la lista de origen de reactivación actual del dispositivo ya ha alcanzado o superado el número de filtros de alimentación que admite el hardware, el controlador puede rechazar este origen de reactivación.

Para obtener más información, consulte Configuración de la administración de energía.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 2004
Plataforma de destino Universal
Versión mínima de UMDF 2,33
Encabezado netdevice.h (include netadaptercx.h)
IRQL PASSIVE_LEVEL