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 |