OID_SWITCH_NIC_DISCONNECT

Hyper-V 可延伸交換器的通訊協定邊緣發出物件識別碼 (OID) 設定OID_SWITCH_NIC_DISCONNECT的要求,以通知基礎可延伸交換器延伸模組,指出可延伸交換器埠與網路介面卡之間的連線正在中斷。 完全中斷連線之後,可延伸交換器的通訊協定邊緣將會發出 OID_SWITCH_NIC_DELETE的 OID 集合要求。

NDIS_OID_REQUEST結構的InformationBuffer成員包含NDIS_SWITCH_NIC_PARAMETERS結構的指標。

備註

NDIS_SWITCH_NIC_PARAMETERS結構的Index成員會指定要建立中斷連線通知之網路介面卡的索引。 具有指定 索引 值的網路介面卡會連線到 PortId 成員所指定的可延伸交換器埠。 如需這些索引值的詳細資訊,請參閱 網路介面卡索引值

當擴充功能處理OID_SWITCH_NIC_DISCONNECT的 OID 集合要求時,擴充功能必須遵循下列指導方針:

  • 延伸模組不得修改與 OID 要求相關聯的 NDIS_SWITCH_NIC_PARAMETERS 結構。

  • OID_SWITCH_NIC_DISCONNECT要求只會通知擴充功能,指出在指定的網路介面卡與可延伸交換器埠之間中斷可延伸交換器連線。 擴充功能處理此 OID 要求之後,它不得執行下列動作:

    • 在發出OID_SWITCH_NIC_DISCONNECT OID 要求的可延伸交換器埠上,產生網路介面卡連線的任何封包流量。

    • 呼叫 ReferenceSwitchNic ,以針對可延伸交換器埠上的指定網路介面卡連線遞增可延伸交換器參考計數器。

    • OID_SWITCH_NIC_REQUEST 的 OID 要求轉送或產生至發出OID_SWITCH_NIC_DISCONNECT OID 要求的基礎網路介面卡。

      注意 如果呼叫 ReferenceSwitchNic 的延伸模組在發出OID_SWITCH_NIC_DISCONNECT之前遞增可延伸交換器參考計數器,擴充功能仍然可以轉送或產生 OID 要求。

    • 從發出 OID_SWITCH_NIC_DISCONNECT OID 要求的基礎網路介面卡轉寄或源自NDIS_STATUS_SWITCH_NIC_STATUS的 NDIS 狀態指示。

      注意 如果呼叫 ReferenceSwitchNic 的延伸模組在發出OID_SWITCH_NIC_DISCONNECT之前遞增可延伸交換器參考計數器,則延伸模組仍然可以向前或產生 NDIS 狀態指示。

      注意 如果先前呼叫 ReferenceSwitchNic 以遞增可延伸交換器參考計數器的擴充功能,則不需要同步處理其呼叫來產生或轉送 OID 要求或 NDIS 狀態指示,以及其管理 Hyper-V 可延伸交換器 OID 要求的程式碼。 擴充功能遞增參考計數器之後,可延伸的交換器介面將不會發出 OID_SWITCH_NIC_DELETE的 OID 集合要求。

  • 延伸模組必須一律將此 OID 集合要求轉送至基礎延伸模組。 延伸模組不得完成要求。

  • 可延伸交換器外部網路介面卡可以系結至一或多個基礎實體介面卡。 對於系結至外部網路介面卡的每個實體網路介面卡,可延伸交換器的通訊協定邊緣會發出個別的 OID 集合要求OID_SWITCH_NIC_DISCONNECT。 每個 OID 集合要求都會指定不同的網路介面卡連線索引值。 如需這些索引值的詳細資訊,請參閱 網路介面卡索引值

    延伸模組必須維護每個基礎實體介面卡的線上狀態。 如需實體網路介面卡可以系結至外部網路介面卡之不同組態的詳細資訊,請參閱 實體網路介面卡組態的類型

注意 擴充功能不得發出自己的 OID 集合要求OID_SWITCH_NIC_DISCONNECT。

如需可延伸交換器埠和網路介面卡線上狀態的詳細資訊,請參閱 Hyper-V 可延伸交換器埠和網路介面卡狀態

傳回狀態碼

可延伸交換器的基礎迷你埠邊緣會完成 OID_SWITCH_NIC_DISCONNECT 的 OID 查詢要求,並傳回下列狀態碼。

狀態碼 描述

NDIS_STATUS_SUCCESS

OID 要求已成功完成。

規格需求

版本

NDIS 6.30 和更新版本支援。

標頭

Ntddndis.h (包括 Ndis.h)

另請參閱


NDIS_OID_REQUEST

NDIS_SWITCH_NIC_PARAMETERS

OID_SWITCH_NIC_DELETE

OID_SWITCH_PORT_ARRAY

ReferenceSwitchPort