NET_ADAPTER_WAKE_REASON_FILTER_PACKET_INIT function (netadaptercx.h)

Article
02/22/2024

The client driver calls the NET_ADAPTER_WAKE_REASON_FILTER_PACKET_INIT function to initialize a NET_ADAPTER_WAKE_REASON_PACKET structure when reporting that a packet matching a driver supported filter caused a wake-up event.

Syntax

void NET_ADAPTER_WAKE_REASON_FILTER_PACKET_INIT(
  [out] NET_ADAPTER_WAKE_REASON_PACKET *Reason
);

Parameters

[out] Reason

A pointer to a driver allocated NET_ADAPTER_WAKE_REASON_PACKET structure.

Return value

None

Remarks

When the NET_WAKE_SOURCE_TYPE is NetWakeSourceTypePacketFilterMatch, call NET_ADAPTER_WAKE_REASON_FILTER_PACKET_INIT to initialize the NET_ADAPTER_WAKE_REASON_PACKET structure. Call NetAdapterReportWakeReasonPacket to report this wake reason to NetAdapterCx.

This function zeroes out the memory for the NET_ADAPTER_WAKE_REASON_PACKET structure, sets the Size member, and sets the PatternId member to NetAdapterWakeFilterPatternId.

Requirements

Requirement	Value
Minimum supported server	Windows Server 2022
Target Platform	Universal
Header	netadaptercx.h (include netadaptercx.h)
IRQL	Any level as long as target memory is resident