Função NetPowerOffloadListGetElement (netpoweroffloadlist.h)

  • Artigo

A função NetPowerOffloadListGetElement obtém um descarregamento de protocolo de baixa potência de uma lista de descarregamentos para um adaptador líquido.

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 e inicializada pelo driver.

[_In_] Index

O índice baseado em zero na lista do objeto NETPOWEROFFLOAD de destino. Essa função deve ser menor que o valor retornado por NetPowerOffloadListGetCount.

Retornar valor

Retorna o objeto NETPOWEROFFLOAD, que representa o descarregamento de protocolo de baixa potência, no índice especificado na lista.

Comentários

Chame NetPowerOffloadListGetCount para obter o número de descarregamentos de protocolo de baixa potência antes de chamar essa função.

O driver do cliente só deve chamar 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_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
Cabeçalho netpoweroffloadlist.h (inclua netadaptercx.h)
IRQL PASSIVE_LEVEL

Confira também

Configurando o gerenciamento de energia

NET_POWER_OFFLOAD_LIST

NetPowerOffloadListGetCount