Função NetPowerOffloadListGetElement (netpoweroffloadlist.h)
A função NetPowerOffloadListGetElement obtém um descarregamento de protocolo de baixa potência de uma lista de descarregamentos para um adaptador de rede.
Sintaxe
NETPOWEROFFLOAD NetPowerOffloadListGetElement(
[_In_] const NET_POWER_OFFLOAD_LIST *List,
[_In_] SIZE_T Index
);
Parâmetros
[_In_] List
Um ponteiro para uma estrutura de NET_POWER_OFFLOAD_LIST alocada por driver e inicializada.
[_In_] Index
O índice baseado em zero na lista do objeto NETPOWEROFFLOAD de destino. Essa função deve ser menor do que o valor retornado por NetPowerOffloadListGetCount.
Valor de retorno
Retorna o objeto NETPOWEROFFLOAD, que representa o descarregamento de protocolo de baixa potência, no índice especificado na lista.
Observações
Chame NetPowerOffloadListGetCount para obter o número de descarregamentos de protocolo de baixa potência antes de chamar essa função.
O driver cliente deve chamar apenas NetPowerOffloadListGetElement 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 |
| da Plataforma de Destino | Universal |
| versão mínima do UMDF | 2.33 |
| cabeçalho | netpoweroffloadlist.h (inclua netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |
Consulte também
Configurando de gerenciamento de energia