OID_SWITCH_NIC_DELETE

發行項
06/15/2023

Hyper-V 可延伸交換器的通訊協定邊緣會發出物件識別碼 (OID) OID_SWITCH_NIC_DELETE至可延伸交換器驅動程式堆疊的要求。此 OID 要求會通知基礎可延伸交換器延伸模組有關刪除可延伸交換器埠與網路介面卡之間的連線。可延伸交換器的通訊協定邊緣先前會在發出 OID 集合要求OID_SWITCH_NIC_DISCONNECT時通知擴充功能正在刪除此連線。

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

備註

NDIS_SWITCH_NIC_PARAMETERS結構的PortId成員會指定要進行刪除通知的埠。可延伸交換器擴充功能可以發出 OID_SWITCH_PORT_ARRAY的 OID 查詢要求，以取得可延伸交換器上這個和其他埠的參數資訊。

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

在可延伸交換器的通訊協定邊緣發出OID_SWITCH_NIC_DELETE要求之前，它可確保已完成指定網路介面卡連線的所有擱置傳送或接收封包要求。通訊協定邊緣也保證已完成介面卡連接的所有擱置 OID 要求，而且介面卡連接的可延伸交換器參考計數器具有零值。

注意如果擴充功能藉由呼叫 ReferenceSwitchNic來遞增網路介面卡的可延伸交換器參考計數器，則當參考計數器為非零時，不會發出OID_SWITCH_NIC_DELETE要求。擴充功能會藉由呼叫 DereferenceSwitchNic來遞減可延伸交換器參考計數器。

延伸模組必須遵循下列指導方針來處理OID_SWITCH_NIC_DELETE的 OID 集合要求：

延伸模組不得修改與 OID 要求相關聯的 NDIS_SWITCH_NIC_PARAMETERS 結構。
延伸模組必須一律將此 OID 集合要求轉送至基礎延伸模組。延伸模組不得完成要求。
擴充功能不得發出自己的 OID 集合要求OID_SWITCH_NIC_DELETE。
可延伸交換器外部網路介面卡可以系結至一或多個基礎實體介面卡。對於系結至外部網路介面卡的每個實體網路介面卡，可延伸交換器的通訊協定邊緣會發出個別的 OID 集合要求OID_SWITCH_NIC_DELETE。每個 OID 集合要求都會指定不同的網路介面卡連線索引值。如需這些索引值的詳細資訊，請參閱網路介面卡索引值。

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