NET_ADAPTER_LINK_STATE_INIT function (netadapter.h)

Article
02/22/2024

Initializes a NET_ADAPTER_LINK_STATE structure.

Syntax

void NET_ADAPTER_LINK_STATE_INIT(
  [_Out_] NET_ADAPTER_LINK_STATE             *LinkState,
  [_In_]  ULONG64                            LinkSpeed,
  [_In_]  NET_IF_MEDIA_CONNECT_STATE         MediaConnectState,
  [_In_]  NET_IF_MEDIA_DUPLEX_STATE          MediaDuplexState,
  [_In_]  NET_ADAPTER_PAUSE_FUNCTION_TYPE    SupportedPauseFunctions,
  [_In_]  NET_ADAPTER_AUTO_NEGOTIATION_FLAGS AutoNegotiationFlags
);

Parameters

[_Out_] LinkState

A pointer to a driver-allocated NET_ADAPTER_LINK_STATE structure.

[_In_] LinkSpeed

The link speed of the adapter in bits per second.

[_In_] MediaConnectState

The media connect state for the network adapter.

[_In_] MediaDuplexState

The media duplex state for the network adapter.

[_In_] SupportedPauseFunctions

Support for the IEEE 802.3 pause frames specified by a NET_ADAPTER_PAUSE_FUNCTION_TYPE value.

[_In_] AutoNegotiationFlags

The auto-negotiation settings for the network adapter. For more info, see NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES.

Return value

None

Remarks

Call NET_ADAPTER_LINK_STATE_INIT or NET_ADAPTER_LINK_STATE_INIT_DISCONNECTED to initialize a NET_ADAPTER_LINK_STATE structure.

An initialized NET_ADAPTER_LINK_STATE structure is an input parameter value to NetAdapterSetLinkState.

Requirements

Requirement	Value
Minimum supported client	Windows 10
Minimum supported server	Windows Server 2016
Minimum KMDF version	1.21
Header	netadapter.h (include netadaptercx.h)
IRQL	<= DISPATCH_LEVEL