Função NetWakeSourceListGetElement (netwakesourcelist.h)

  • Artigo

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

[_In_] Index

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

Retornar valor

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

Comentários

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

O driver cliente só deve chamar 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_S0 ou 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 como trabalhar com objetos NETWAKESOURCE, 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 netwakesourcelist.h (inclua netadaptercx.h)
Biblioteca netadaptercxstub.lib
IRQL PASSIVE_LEVEL

Confira também

Configurando o gerenciamento de energia

NET_WAKE_SOURCE_LIST

NetWakeSourceListGetCount