NetWakeSourceGetAdapter function (netwakesource.h)

The NetWakeSourceGetAdapter function gets the net adapter for a wake-on-LAN (WoL) source.

Syntax

NETADAPTER NetWakeSourceGetAdapter(
  [_In_] NETWAKESOURCE WakeSource
);

Parameters

[_In_] WakeSource

The NETWAKESOURCE object that represents the source of the wake-up event.

Return value

Returns the NETADAPTER object that represents the net adapter for this wake source.

Remarks

Client drivers that have one network adapter per device do not need to call this optional function. Call NetWakeSourceGetAdapter if your device has more than one net adapter object per device, such as in a MBBCx client driver.

The client driver must only call NetWakeSourceGetAdapter during a power transition, typically from its EVT_WDF_DEVICE_ARM_WAKE_FROM_SX, EVT_WDF_DEVICE_ARM_WAKE_FROM_S0, or EVT_NET_DEVICE_PREVIEW_WAKE_SOURCE callback function. Otherwise, the call results in a system bugcheck.

Requirements

Requirement Value
Minimum supported client Windows 10, version 2004
Minimum UMDF version 2.33
Header netwakesource.h (include netadaptercx.h)
Library netadaptercxstub.lib
IRQL PASSIVE_LEVEL

See also

Configuring power management

[NetWakeSourceListGetElement]