Compartilhar via

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

  • Artigo

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.

Retornar valor

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.

Comentários

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 funcionalidades, 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_CALLBACKS e, em seguida, chamando NetDeviceInitSetPowerPolicyEventCallbacks.

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

Nesse 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 Configurando o Gerenciamento de Energia.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 2004
Versão mínima do UMDF 2.33
Cabeçalho netdevice.h (inclua netadaptercx.h)
IRQL PASSIVE_LEVEL