Função NetWakeSourceListGetElement (netwakesourcelist.h)

A função NetWakeSourceListGetElement obtém uma fonte de ativação da lista de fontes de ativação para um adaptador de rede.

Sintaxe

NETWAKESOURCE NetWakeSourceListGetElement(
  [_In_] const NET_WAKE_SOURCE_LIST *List,
  [_In_] SIZE_T                     Index
);

Parâmetros

[_In_] List

Um identificador para uma estrutura de NET_WAKE_SOURCE_LIST alocada por driver e inicializada.

[_In_] Index

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

Valor de retorno

Retorna o objeto NETWAKESOURCE, que representa a fonte de ativação, no índice especificado na lista.

Observações

Chame NetWakeSourceListGetCount para obter o número de fontes de ativação antes de chamar essa função.

O driver cliente deve chamar apenas NetWakeSourceListGetElement 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_WAKE_SOURCE. 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 NETWAKESOURCE, consulte Configurandode gerenciamento de energia.

Requisitos

Consulte também

Configurando de gerenciamento de energia

NET_WAKE_SOURCE_LIST

NetWakeSourceListGetCount