Skip to content

Latest commit

 

History

History
210 lines (119 loc) · 6.26 KB

ns-ntddndis-_ndis_link_state.md

File metadata and controls

210 lines (119 loc) · 6.26 KB
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NS:ntddndis._NDIS_LINK_STATE
_NDIS_LINK_STATE (ntddndis.h)
The NDIS_LINK_STATE structure specifies the current link state of a miniport adapter.
netvista\ndis_link_state.htm
netvista
05/02/2018
NDIS_LINK_STATE structure
*PNDIS_LINK_STATE, NDIS_LINK_STATE, NDIS_LINK_STATE structure [Network Drivers Starting with Windows Vista], PNDIS_LINK_STATE, PNDIS_LINK_STATE structure pointer [Network Drivers Starting with Windows Vista], _NDIS_LINK_STATE, netvista.ndis_link_state, ntddndis/NDIS_LINK_STATE, ntddndis/PNDIS_LINK_STATE
ntddndis.h
Ndis.h
Windows
Supported in NDIS 6.0 and later.
Windows
NDIS_LINK_STATE, *PNDIS_LINK_STATE
_NDIS_LINK_STATE
ntddndis/_NDIS_LINK_STATE
PNDIS_LINK_STATE
ntddndis/PNDIS_LINK_STATE
NDIS_LINK_STATE
ntddndis/NDIS_LINK_STATE
APIRef
kbSyntax
HeaderDef
ntddndis.h
_NDIS_LINK_STATE
PNDIS_LINK_STATE
NDIS_LINK_STATE

_NDIS_LINK_STATE structure

-description

The NDIS_LINK_STATE structure specifies the current link state of a miniport adapter.

-struct-fields

-field Header

The NDIS_OBJECT_HEADER structure for the NDIS_LINK_STATE structure. Set the Type member of the structure that Header specifies to NDIS_OBJECT_TYPE_DEFAULT, the Revision member to NDIS_LINK_STATE_REVISION_1, and the Size member to NDIS_SIZEOF_LINK_STATE_REVISION_1.

-field MediaConnectState

The media connect state for the miniport adapter. For more information, see
OID_GEN_MEDIA_CONNECT_STATUS_EX OID.

-field MediaDuplexState

The media duplex state for the miniport adapter. For more information, see OID_GEN_MEDIA_DUPLEX_STATE OID.

-field XmitLinkSpeed

The current transmit link speed of the miniport adapter in bits per second. For more information, see OID_GEN_LINK_SPEED_EX.

Note  A value of NDIS_LINK_SPEED_UNKNOWN indicates that the transmit link speed is unknown.
 

-field RcvLinkSpeed

The current receive link speed of the miniport adapter in bits per second. For more information, see OID_GEN_LINK_SPEED_EX.

Note  A value of NDIS_LINK_SPEED_UNKNOWN indicates that the receive link speed is unknown.
 

-field PauseFunctions

The type of support for the IEEE 802.3 pause frames. This member must be one of the following pause functions:

NdisPauseFunctionsUnsupported

the miniport adapter or link partner does not support pause frames.

NdisPauseFunctionsSendOnly

the miniport adapter and link partner support only sending pause frames from the miniport adapter to the link partner.

NdisPauseFunctionsReceiveOnly

the miniport adapter and link partner support only sending pause frames from the link partner to the miniport adapter

NdisPauseFunctionsSendAndReceive

the miniport adapter and link partner support sending and receiving pause frames in both transmit and receive directions.

NdisPauseFunctionsUnknown

Pause frame negotiation is in progress. The pause frame support that the link partner provides is unknown.

-field AutoNegotiationFlags

The auto-negotiation settings for the miniport adapter. This member is created from a bitwise OR of the following flags:

NDIS_LINK_STATE_XMIT_LINK_SPEED_AUTO_NEGOTIATED

the miniport adapter has auto-negotiated the transmit link speed with the link partner.

NDIS_LINK_STATE_RCV_LINK_SPEED_AUTO_NEGOTIATED

the miniport adapter has auto-negotiated the receive link speed with the link partner.

NDIS_LINK_STATE_DUPLEX_AUTO_NEGOTIATED

the miniport adapter has auto-negotiated the duplex state with the link partner.

NDIS_LINK_STATE_PAUSE_FUNCTIONS_AUTO_NEGOTIATED

the miniport adapter has auto-negotiated the pause functions with the link partner.

-remarks

Miniport drivers use the NDIS_STATUS_LINK_STATE status indication to notify NDIS and overlying drivers that there has been a change in the physical characteristics of a medium.

When it generates this status indication, the driver sets the StatusBuffer member of the NDIS_STATUS_INDICATION structure to a pointer to an NDIS_LINK_STATE structure.

The miniport driver also returns an NDIS_LINK_STATE structure when it handles an OID query request of OID_GEN_LINK_STATE.

-see-also

NDIS_OBJECT_HEADER

NDIS_STATUS_INDICATION

NDIS_STATUS_LINK_STATE

OID_GEN_LINK_SPEED_EX

OID_GEN_LINK_STATE

OID_GEN_MEDIA_CONNECT_STATUS_EX OID_GEN_MEDIA_DUPLEX_STATE