NDIS_LINK_STATE 结构 (ntddndis.h)

项目
08/07/2023

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结构。将 Header 指定的结构的 Type 成员设置为 NDIS_OBJECT_TYPE_DEFAULT，将 Revision 成员设置为 NDIS_LINK_STATE_REVISION_1，并将 Size 成员设置为 NDIS_SIZEOF_LINK_STATE_REVISION_1。

MediaConnectState

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

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 和过度配置驱动程序介质的物理特征发生了更改。

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

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

要求

要求	值
最低受支持的客户端	在 NDIS 6.0 及更高版本中受支持。
标头	ntddndis.h (包括 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

通过