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
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 10, versão 2004 |
| da 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 |
Consulte também
Configurando de gerenciamento de energia