Compartilhar via


estrutura NET_WAKE_SOURCE_LIST (netwakesourcelist.h)

A estrutura NET_WAKE_SOURCE_LIST representa uma lista de fontes wol (wake-on-LAN) para um adaptador de rede.

Sintaxe

typedef struct _NET_WAKE_SOURCE_LIST {
  ULONG Size;
  void  *Reserved[4];
} NET_WAKE_SOURCE_LIST;

Membros

Size

O tamanho dessa estrutura, em bytes.

Reserved[4]

Reservado. Os drivers de cliente não devem ler ou gravar diretamente nesse valor.

Observações

Chame NET_WAKE_SOURCE_LIST_INIT para inicializar essa estrutura e, em seguida, chame netDeviceGetWakeSourceList para obter a lista de fontes de ativação deste adaptador de rede. Depois de obter a lista, chame NetWakeSourceListGetCount com essa estrutura para obter o número de objetos NETWAKESOURCE que representam as fontes de ativação e, em seguida, faça loop sobre os objetos e chame NetWakeSourceListGetElement para recuperar cada um deles. Depois de obter um objeto NETWAKESOURCE, chame NetWakeSourceGetType para obter o tipo dessa fonte de ativação para que você possa chamar a função apropriada para obter os parâmetros da fonte de ativação.

O driver cliente deve chamar apenas funções relacionadas à fonte de ativação 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
versão mínima do UMDF 2.33
cabeçalho netwakesourcelist.h (inclua netadaptercx.h)

Consulte também

Configurando de gerenciamento de energia

NET_WAKE_SOURCE_LIST_INIT

NetDeviceGetWakeSourceList

NetWakeSourceListGetCount

NetWakeSourceListGetElement

NetWakeSourceGetType