NetWakeSourceGetMediaChangeParameters function (netwakesource.h)

Article
02/22/2024

The NetWakeSourceGetMediaChangeParameters function gets parameters for a media change wake source.

Syntax

void NetWakeSourceGetMediaChangeParameters(
  [_In_]    NETWAKESOURCE                           WakeSource,
  [_Inout_] NET_WAKE_SOURCE_MEDIA_CHANGE_PARAMETERS *Parameters
);

Parameters

[_In_] WakeSource

A NETWAKESOURCE object that represents this media change wake source.

[_Inout_] Parameters

A pointer to a driver-allocated and initialized NET_WAKE_SOURCE_MEDIA_CHANGE_PARAMETERS structure that receives the media change parameters.

Return value

None

Remarks

Call NET_WAKE_SOURCE_MEDIA_CHANGE_PARAMETERS_INIT to initialize the NET_WAKE_SOURCE_MEDIA_CHANGE_PARAMETERS structure before calling this function.

The client driver must only call NetWakeSourceGetMediaChangeParameters 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
Target Platform	Universal
Header	netwakesource.h (include netadaptercx.h)
Library	netadaptercxstub.lib
IRQL	PASSIVE_LEVEL