Compartilhar via


Função NetPowerOffloadListGetCount (netpoweroffloadlist.h)

A função NetPowerOffloadListGetCount obtém o número de descarregamentos de protocolo de baixa potência para um adaptador líquido.

Sintaxe

SIZE_T NetPowerOffloadListGetCount(
  [_In_] const NET_POWER_OFFLOAD_LIST *List
);

Parâmetros

[_In_] List

Um ponteiro para uma estrutura de NET_POWER_OFFLOAD_LIST alocada e inicializada por driver.

Retornar valor

Retorna o número de descarregamentos de energia baixos para esse adaptador líquido.

Comentários

Chame NET_POWER_OFFLOAD_LIST_INIT para inicializar a estrutura de NET_POWER_OFFLOAD_LIST e, em seguida, chame NetDeviceGetPowerOffloadList para recuperar a lista de descarregamento de protocolo de baixa energia. Depois de obter a lista, chame essa função para determinar quantos descarregamentos de protocolo de baixa potência existem nesse adaptador de rede.

O driver cliente só deve chamar NetPowerOffloadListGetCount 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.

Requisitos

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

Confira também

Configurando o gerenciamento de energia

NET_POWER_OFFLOAD_LIST_INIT

NET_POWER_OFFLOAD_LIST

NetDeviceGetPowerOffloadList