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.
EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD EvtNetDevicePreviewPowerOffload;
NTSTATUS EvtNetDevicePreviewPowerOffload(
[_In_] WDFDEVICE Device,
[_In_] NETPOWEROFFLOAD PowerOffload
)
{...}
[_In_] Device
Objeto WDFDEVICE que el controlador cliente obtuvo previamente con una llamada a WdfDeviceCreate.
[_In_] PowerOffload
Objeto NETPOWEROFFLOAD que representa la descarga del protocolo de baja potencia que se va a examinar.
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.
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 funcionalidad, 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_CALLBACKSy 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 cliente obtienen la oportunidad de rechazar la descarga del protocolo. Por ejemplo, si el número de descargas de protocolo en la lista de descarga de protocolo actual para 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 Power Management.
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 10, versión 2004 |
| versión mínima de UMDF | 2.33 |
| encabezado de | netdevice.h (include netadaptercx.h) |
| irQL | PASSIVE_LEVEL |