OID_SWITCH_NIC_CONNECT
Hyper-V 可延伸交換器的通訊協定邊緣會發出物件識別碼 (OID) 集要求OID_SWITCH_NIC_CONNECT,以通知基礎可延伸交換器擴充功能,指出可延伸交換器埠與網路介面卡之間的網路連線已完全建立。 通訊協定邊緣先前會通知擴充功能,指出在發出 OID_SWITCH_NIC_CREATE的 OID 集合要求時,正在建立此連線。
NDIS_OID_REQUEST結構的InformationBuffer成員包含NDIS_SWITCH_NIC_PARAMETERS結構的指標。
備註
NDIS_SWITCH_NIC_PARAMETERS結構的PortId成員會指定要建立連接通知的可延伸交換器埠。 可延伸交換器擴充功能可以透過下列方式取得此埠和其他可延伸交換器埠的參數資訊:
發出 OID_SWITCH_PORT_ARRAY的 OID 查詢要求。 只有在OID_SWITCH_PARAMETERS傳回IsActive設定為 TRUE的NDIS_SWITCH_PARAMETERS結構時,擴充功能才會在FilterAttach上發出這個 OID。 如果 IsActive 為 FALSE,擴充功能會在擴充功能迷你埠配接器發出 NetEventSwitchActivateNET_PNP_EVENT 時發出 OID。
藉由檢查 OID_SWITCH_PORT_CREATE 和 OID_SWITCH_PORT_DELETE的各種 OID 集合要求。
NDIS_SWITCH_NIC_PARAMETERS結構的Index成員會指定要建立連線通知之網路介面卡的索引。 具有指定 Index 值的網路介面卡會連線到 PortId 成員所指定的可延伸交換器埠。 如需這些索引值的詳細資訊,請參閱 網路介面卡索引值。
當它收到OID_SWITCH_NIC_CONNECT的 OID 集合要求時,延伸模組必須遵循下列指導方針:
當OID_SWITCH_NIC_CONNECT要求NDIS_STATUS_SUCCESS完成時,網路連線和可延伸交換器埠會完全運作。 擴充功能可以產生或轉送封包流量至埠的網路連線。 擴充功能也可以發出可延伸交換器 OID,或是使用埠作為來源埠的狀態指示。 擴充功能也可以呼叫 ReferenceSwitchPort 來遞增埠的可延伸交換器參考計數器。
延伸模組不得修改與 OID 要求相關聯的 NDIS_SWITCH_NIC_PARAMETERS 結構。
擴充功能必須一律呼叫 NdisFOidRequest ,將此 OID 要求轉送到基礎延伸模組。 延伸模組不得完成 OID 要求本身。
可延伸交換器外部網路介面卡可以系結至一或多個基礎實體介面卡。 對於系結至外部網路介面卡的每個實體網路介面卡,可延伸交換器的通訊協定邊緣會發出個別的 OID 集合要求OID_SWITCH_NIC_CONNECT。 每個 OID 集合要求都會指定不同的網路介面卡連線索引值。 如需這些值的詳細資訊,請參閱 網路介面卡索引值。
擴充功能必須維護系結至外部網路介面卡之每個基礎實體介面卡的線上狀態。 如需實體網路介面卡可以系結至外部網路介面卡之不同組態的詳細資訊,請參閱 實體網路介面卡組態的類型。
注意 擴充功能不得發出自己的 OID 集合要求OID_SWITCH_NIC_CONNECT。
如需可延伸交換器埠和網路介面卡線上狀態的詳細資訊,請參閱 Hyper-V 可延伸交換器埠和網路介面卡狀態。
傳回狀態碼
可延伸交換器的基礎迷你埠邊緣會完成OID_SWITCH_NIC_CONNECT的 OID 集合要求,並傳回下列狀態碼。
狀態碼 | 描述 |
---|---|
NDIS_STATUS_SUCCESS |
OID 要求已順利完成。 |
規格需求
版本 |
NDIS 6.30 和更新版本支援。 |
標頭 |
Ntddndis.h (包含 Ndis.h) |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應