EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD função de retorno de chamada (netdevice.h)

Artigo
02/07/2025

Implemente esse retorno de chamada opcional para rejeitar descarregamentos de protocolo que não são compatíveis com seu hardware.

Sintaxe

EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD EvtNetDevicePreviewPowerOffload;

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

Parâmetros

[_In_] Device

O objeto WDFDEVICE que o driver cliente obteve anteriormente com uma chamada para WdfDeviceCreate.

[_In_] PowerOffload

Um objeto NETPOWEROFFLOAD que representa o descarregamento de protocolo de baixa potência a ser examinado.

Valor de retorno

Para aceitar o descarregamento de protocolo, a função de retorno de chamada deve retornar STATUS_SUCCESS.

Para rejeitar o descarregamento de protocolo, retorne STATUS_NDIS_PM_PROTOCOL_OFFLOAD_LIST_FULL.

Observações

Os drivers não são necessários para implementar EvtNetDevicePreviewPowerOffload, pois o NetAdapterCx já bloqueia descarregamentos de protocolo que não são compatíveis com os recursos de descarregamento de energia do driver: NET_ADAPTER_POWER_OFFLOAD_ARP_CAPABILITIES e NET_ADAPTER_POWER_OFFLOAD_NS_CAPABILITIES. No entanto, se o hardware tiver limitações adicionais que não podem ser expressas nessas estruturas de recursos, você poderá fornecer evtNetDevicePreviewPowerOffload para impor essas limitações adicionais.

Registre sua implementação dessa função de retorno de chamada definindo o membro apropriado do NET_DEVICE_POWER_POLICY_EVENT_CALLBACKSe, em seguida, chamando NetDeviceInitSetPowerPolicyEventCallbacks.

Os drivers cliente normalmente chamam NetDeviceInitSetPowerPolicyEventCallbacks ao criar o objeto do dispositivo, antes de chamar WdfDeviceCreate.

Neste retorno de chamada, os drivers cliente têm a chance de rejeitar o descarregamento do protocolo. Por exemplo, se o número de descarregamentos de protocolo na lista de descarregamento de protocolo atual para Dispositivo já tiver atingido ou excedido o número de descarregamentos de protocolo compatíveis com o hardware, o driver poderá rejeitar esse descarregamento de protocolo.

Para obter mais informações, consulte Configuring Power Management.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10, versão 2004
versão mínima do UMDF	2.33
cabeçalho	netdevice.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL

Compartilhar via