Função NetWakeSourceGetAdapter (netwakesource.h)

Artigo
02/07/2025

A função NetWakeSourceGetAdapter obtém o adaptador de rede para uma origem wol (wake-on-LAN).

Sintaxe

NETADAPTER NetWakeSourceGetAdapter(
  [_In_] NETWAKESOURCE WakeSource
);

Parâmetros

[_In_] WakeSource

O objeto NETWAKESOURCE que representa a origem do evento de ativação.

Valor de retorno

Retorna o objeto NETADAPTER que representa o adaptador de rede para essa fonte de ativação.

Observações

Os drivers de cliente que têm um adaptador de rede por dispositivo não precisam chamar essa função opcional. Chame NetWakeSourceGetAdapter se o dispositivo tiver mais de um objeto de adaptador de rede por dispositivo, como em um de driver de cliente MBBCx.

O driver cliente deve chamar apenas netWakeSourceGetAdapter 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.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10, versão 2004
versão mínima do UMDF	2.33
cabeçalho	netwakesource.h (inclua netadaptercx.h)
biblioteca	netadaptercxstub.lib
IRQL	PASSIVE_LEVEL

Consulte também

Configurando de gerenciamento de energia

[NetWakeSourceListGetElement]

Partilhar via