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 |