estrutura NET_POWER_OFFLOAD_LIST (netpoweroffloadlist.h)

Artigo
05/23/2024

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

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.

Comentários

Chame NET_POWER_OFFLOAD_LIST_INIT para inicializar essa estrutura e, em seguida, chame NetDeviceGetPowerOffloadList para obter a lista de descarregamentos de baixa energia 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_S0 ou 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 como trabalhar com objetos NETPOWEROFFLOAD, consulte Configurando o gerenciamento de energia.