OID_SWITCH_NIC_CONNECT

發行項
07/08/2024

Hyper-V 可延伸交換器的通訊協定邊緣發出OID_SWITCH_NIC_CONNECT的對象識別碼（OID）集合要求，以通知基礎可延伸交換器擴充功能，指出已完全建立可延伸交換器埠與網路適配器之間的網路連線。通訊協定邊緣先前已通知擴充功能，指出在發出 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，當擴充功能迷你埠配接器發出 NetEventSwitchActivate NET_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 集合要求都會指定不同的網路適配器連線索引值。如需這些值的詳細資訊，請參閱網路適配器索引值。

延伸模組必須維護系結至外部網路適配器之每個基礎實體適配卡的連接狀態。如需實體網路適配器可以系結至外部網路適配器之不同組態的詳細資訊，請參閱實體網路適配器組態的類型。