Função NetWakeSourceListGetElement (netwakesourcelist.h)

A função NetWakeSourceListGetElement obtém uma fonte de ativação da lista de fontes de ativação de 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 pelo 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 do 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
Versão mínima do UMDF	2.33
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