NDIS_LINK_STATE结构（ntddndis.h）

项目
02/07/2025

NDIS_LINK_STATE 结构指定微型端口适配器的当前链接状态。

语法

typedef struct _NDIS_LINK_STATE {
  NDIS_OBJECT_HEADER             Header;
  NDIS_MEDIA_CONNECT_STATE       MediaConnectState;
  NDIS_MEDIA_DUPLEX_STATE        MediaDuplexState;
  ULONG64                        XmitLinkSpeed;
  ULONG64                        RcvLinkSpeed;
  NDIS_SUPPORTED_PAUSE_FUNCTIONS PauseFunctions;
  ULONG                          AutoNegotiationFlags;
} NDIS_LINK_STATE, *PNDIS_LINK_STATE;

成员

Header

NDIS_LINK_STATE 结构的 NDIS_OBJECT_HEADER 结构。将标头指定为NDIS_OBJECT_TYPE_DEFAULT的结构类型成员，将修订成员设置为NDIS_LINK_STATE_REVISION_1，并将大小成员设置为NDIS_SIZEOF_LINK_STATE_REVISION_1。

MediaConnectState

微型端口适配器的媒体连接状态。有关详细信息，请参阅
OID_GEN_MEDIA_CONNECT_STATUS_EX OID。

MediaDuplexState

微型端口适配器的媒体双工状态。有关详细信息，请参阅 OID_GEN_MEDIA_DUPLEX_STATE OID。

XmitLinkSpeed

微型端口适配器的当前传输链路速度（以位/秒为单位）。有关详细信息，请参阅 OID_GEN_LINK_SPEED_EX。

注意 NDIS_LINK_SPEED_UNKNOWN值表示传输链路速度未知。

RcvLinkSpeed

微型端口适配器的当前接收链路速度（以位/秒为单位）。有关详细信息，请参阅 OID_GEN_LINK_SPEED_EX。

注意值NDIS_LINK_SPEED_UNKNOWN指示接收链接速度未知。

PauseFunctions

IEEE 802.3 暂停帧的支持类型。此成员必须是以下暂停函数之一：

NdisPauseFunctionsUnsupported

微型端口适配器或链接伙伴不支持暂停帧。

NdisPauseFunctionsSendOnly

微型端口适配器和链接合作伙伴仅支持将暂停帧从微型端口适配器发送到链接伙伴。

NdisPauseFunctionsReceiveOnly

微型端口适配器和链接合作伙伴仅支持将暂停帧从链接伙伴发送到微型端口适配器

NdisPauseFunctionsSendAndReceive

微型端口适配器和链接合作伙伴支持在传输和接收方向中发送和接收暂停帧。

NdisPauseFunctionsUnknown

正在进行暂停帧协商。链接合作伙伴提供的暂停帧支持未知。

AutoNegotiationFlags

微型端口适配器的自动协商设置。此成员是从以下标志的按位 OR 创建的：

NDIS_LINK_STATE_XMIT_LINK_SPEED_AUTO_NEGOTIATED

微型端口适配器已与链接伙伴自动协商传输链路速度。

NDIS_LINK_STATE_RCV_LINK_SPEED_AUTO_NEGOTIATED

微型端口适配器已与链接伙伴自动协商接收链接速度。

NDIS_LINK_STATE_DUPLEX_AUTO_NEGOTIATED

微型端口适配器已与链接伙伴自动协商双工状态。

NDIS_LINK_STATE_PAUSE_FUNCTIONS_AUTO_NEGOTIATED

微型端口适配器已与链接伙伴自动协商暂停功能。

言论

微型端口驱动程序使用 NDIS_STATUS_LINK_STATE 状态指示来通知 NDIS 和过度显示驱动程序，媒体的物理特征发生了变化。

当它生成此状态指示时，驱动程序会将 StatusBufferNDIS_STATUS_INDICATION 结构的成员设置为指向 NDIS_LINK_STATE 结构的指针。

微型端口驱动程序在处理 OID_GEN_LINK_STATE的 OID 查询请求时也会返回 NDIS_LINK_STATE 结构。

要求

要求	价值
最低支持的客户端	NDIS 6.0 及更高版本中受支持。
标头	ntddndis.h （include Ndis.h）

另请参阅

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

通过