Share via

OID_GEN_LINK_PARAMETERS

  • 项目

作为一个集，NDIS 和上部驱动程序使用 OID_GEN_LINK_PARAMETERS OID 来设置微型端口适配器的当前链接状态。 微型端口驱动程序在NDIS_LINK_PARAMETERS结构中接收双工状态、链接速度和暂停功能。

版本信息

Windows Vista 和更高版本的 Windows
。

NDIS 6.0 及更高版本的微型端口驱动程序
可选。

NDIS_LINK_PARAMETERS结构定义如下：

    typedef struct _NDIS_LINK_PARAMETERS {
         NDIS_OBJECT_HEADER Header;
         NDIS_MEDIA_DUPLEX_STATE MediaDuplexState;
         ULONG64 XmitLinkSpeed;
         ULONG64 RcvLinkSpeed;
         NDIS_SUPPORTED_PAUSE_FUNCTIONS PauseFunctions;
         ULONG AutoNegotiationFlags;
    } NDIS_LINK_PARAMETERS, *PNDIS_LINK_PARAMETERS;

此结构包含以下成员：

头
NDIS_LINK_PARAMETERS结构的NDIS_OBJECT_HEADER结构。 将 Header 指定的结构的 Type 成员设置为 NDIS_OBJECT_TYPE_DEFAULT，将 Revision 成员设置为NDIS_LINK_PARAMETERS_REVISION_1，将 Size 成员设置为NDIS_SIZEOF_LINK_PARAMETERS_REVISION_1。

MediaDuplexState
媒体双工状态。 此值与 OID_GEN_MEDIA_DUPLEX_STATE OID 返回的值相同。

XmitLinkSpeed
传输链路速度（以位/秒为单位）。

RcvLinkSpeed
接收链接速度（以位/秒为单位）。

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

NdisPauseFunctionsUnsupported
适配器或链接伙伴不支持暂停帧。

NdisPauseFunctionsSendOnly
适配器和链接伙伴仅支持将暂停帧从适配器发送到链接伙伴。

NdisPauseFunctionsReceiveOnly
适配器和链接伙伴仅支持将暂停帧从链接伙伴发送到适配器

NdisPauseFunctionsSendAndReceive
适配器和链接伙伴支持在发送和接收方向上发送和接收暂停帧。

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

NDIS_LINK_STATE_XMIT_LINK_SPEED_AUTO_NEGOTIATED
适配器应与链路伙伴自动协商传输链路速度。 如果未设置此标志，微型端口驱动程序应将传输链接速度设置为 XmitLinkSpeed 成员中指定的值。

NDIS_LINK_STATE_RCV_LINK_SPEED_AUTO_NEGOTIATED
适配器应与链接伙伴自动协商接收链接速度。 如果未设置此标志，微型端口驱动程序应将接收链接速度设置为 RcvLinkSpeed 成员中指定的值。

NDIS_LINK_STATE_DUPLEX_AUTO_NEGOTIATED
适配器应与链接伙伴自动协商双工状态。 如果未设置此标志，微型端口驱动程序应将双工状态设置为 MediaDuplexState 成员中指定的值。

NDIS_LINK_STATE_PAUSE_FUNCTIONS_AUTO_NEGOTIATED
微型端口驱动程序应与另一端自动协商对暂停帧的支持。 如果未设置此标志，微型端口驱动程序应使用 PauseFunctions 成员中指定的暂停帧支持。

注解

注意 设置OID_GEN_LINK_PARAMETERS可能会导致连接丢失。 设置此 OID 时，微型端口驱动程序必须重新配置微型端口适配器。 例如，微型端口驱动程序可以重置微型端口适配器，从而导致现有连接丢失。 重新配置的特定机制依赖于应用程序。

如果微型端口适配器的链接状态由于OID_GEN_LINK_PARAMETERS集请求而更改，微型端口驱动程序应生成 NDIS_STATUS_LINK_STATE 状态指示，以通知 NDIS 和过度分配驱动程序的新链接状态。

要求

标头

 Ntddndis.h (包括 Ndis.h)

另请参阅

NDIS_OBJECT_HEADER

NDIS_STATUS_LINK_STATE

OID_GEN_MEDIA_DUPLEX_STATE