NDIS_LINK_STATE 結構 (ntddndis.h)

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_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