OID_GEN_LINK_PARAMETERS
設定時,NDIS 和過度使用 OID OID_GEN_LINK_PARAMETERS OID 來設定迷你埠介面卡目前的連結狀態。 迷你埠驅動程式會在NDIS_LINK_PARAMETERS結構中接收雙工狀態、連結速度及暫停函式。
版本資訊
Windows Vista 和更新版本的 Windows
支援。
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指定要NDIS_OBJECT_TYPE_DEFAULT之結構的Type成員、要NDIS_LINK_PARAMETERS_REVISION_1的Revision成員,以及要NDIS_SIZEOF_LINK_PARAMETERS_REVISION_1的 Size成員。
MediaDuplexState
媒體雙工狀態。 這個值與 OID_GEN_MEDIA_DUPLEX_STATE OID 所傳回的值相同。
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) |