estrutura NET_WAKE_SOURCE_LIST (netwakesourcelist.h)

Artigo
02/26/2024

A estrutura NET_WAKE_SOURCE_LIST representa uma lista de fontes de wake-on-LAN (WoL) 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.

Comentários

Chame NET_WAKE_SOURCE_LIST_INIT para inicializar essa estrutura e, em seguida, chame NetDeviceGetWakeSourceList para obter a lista de fontes de ativação desse 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 um 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 só deve chamar 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_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.