Compartilhar via


NET_POWER_OFFLOAD_LIST estrutura (netpoweroffloadlist.h)

A estrutura NET_POWER_OFFLOAD_LIST representa uma lista de descarregamentos de protocolo de baixa potência para um adaptador de rede.

Sintaxe

typedef struct _NET_POWER_OFFLOAD_LIST {
  ULONG Size;
  void  *Reserved[4];
} NET_POWER_OFFLOAD_LIST;

Membros

Size

O tamanho dessa estrutura, em bytes.

Reserved[4]

Reservado. Os drivers de cliente não devem ler ou gravar diretamente nesse valor.

Observações

Chame NET_POWER_OFFLOAD_LIST_INIT para inicializar essa estrutura e, em seguida, chame NetDeviceGetPowerOffloadList para obter a lista de descarregamentos de energia baixos para esse adaptador de rede. Depois de obter a lista, chame NetPowerOffloadListGetCount com essa estrutura para obter o número de objetos NETPOWEROFFLOAD que representam os descarregamentos e, em seguida, faça loop sobre os objetos e chame NetPowerOffloadListGetElement para recuperar cada um deles. Depois de obter um objeto NETPOWEROFFLOAD, chame NetPowerOffloadGetType para obter o tipo desse descarregamento para que você possa chamar a função apropriada para obter os parâmetros do descarregamento.

O driver cliente só deve chamar funções relacionadas ao descarregamento de energia durante uma transição de energia, normalmente de sua função de retorno de chamada EVT_WDF_DEVICE_ARM_WAKE_FROM_SX, EVT_WDF_DEVICE_ARM_WAKE_FROM_S0ou EVT_NET_DEVICE_PREVIEW_POWER_OFFLOAD. Caso contrário, a chamada resultará em uma verificação de bugs do sistema.

Para obter um exemplo de código de trabalho com objetos NETPOWEROFFLOAD, consulte Configurando o gerenciamento de energia.

Requisitos

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

Consulte também

Configurando de gerenciamento de energia

NET_POWER_OFFLOAD_LIST_INIT

NetDeviceGetPowerOffloadList

NetPowerOffloadListGetCount

netPowerOffloadListGetElement

NetPowerOffloadGetType