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

Implemente esta devolución de llamada opcional para rechazar las descargas de protocolo que no son compatibles con el hardware.

Sintaxis

EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD EvtNetDevicePreviewPowerOffload;

NTSTATUS EvtNetDevicePreviewPowerOffload(
  [_In_] WDFDEVICE Device,
  [_In_] NETPOWEROFFLOAD PowerOffload
)
{...}

Parámetros

[_In_] Device

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

[_In_] PowerOffload

Objeto NETPOWEROFFLOAD que representa la descarga del protocolo de baja energía que se va a examinar.

Valor devuelto

Para aceptar la descarga del protocolo, la función de devolución de llamada debe devolver STATUS_SUCCESS.

Para rechazar la descarga del protocolo, devuelva STATUS_NDIS_PM_PROTOCOL_OFFLOAD_LIST_FULL.

Comentarios

Los controladores no son necesarios para implementar EvtNetDevicePreviewPowerOffload, ya que NetAdapterCx ya bloquea las descargas de protocolo que no son compatibles con las funcionalidades de descarga de energía del controlador: NET_ADAPTER_POWER_OFFLOAD_ARP_CAPABILITIES y NET_ADAPTER_POWER_OFFLOAD_NS_CAPABILITIES. Sin embargo, si el hardware tiene limitaciones adicionales que no se pueden expresar en estas estructuras de funcionalidades, puede proporcionar EvtNetDevicePreviewPowerOffload 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 la descarga del protocolo. Por ejemplo, si el número de descargas de protocolos en la lista de descarga de protocolo actual del dispositivo ya ha alcanzado o superado el número de descargas de protocolo que admite el hardware, el controlador puede rechazar esta descarga de protocolo.

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
Versión mínima de UMDF 2,33
Encabezado netdevice.h (include netadaptercx.h)
IRQL PASSIVE_LEVEL