OID_SWITCH_PORT_DELETE

Hyper-V 可延伸交換器的通訊協定邊緣會發出物件識別碼 (OID) OID_SWITCH_PORT_DELETE的要求，以通知可延伸交換器延伸模組刪除可延伸交換器埠。

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

備註

NDIS_SWITCH_PORT_PARAMETERS結構的PortId成員會指定要進行刪除通知的可延伸交換器埠。

如果網路介面卡連線到指定的埠，可延伸交換器的通訊協定邊緣將會先刪除連線，再刪除埠。在此情況下，通訊協定邊緣會遵循下列步驟，再刪除埠：

通訊協定邊緣發出 OID_SWITCH_NIC_DISCONNECT 的 OID 集合要求，以通知延伸模組網路介面卡與可延伸交換器埠之間的連線正在刪除。
取消或完成指定之可延伸交換器埠的所有擱置封包之後，通訊協定邊緣會發出 OID 集合 OID_SWITCH_NIC_DELETE 要求，以通知延伸模組網路介面卡與可延伸交換器埠之間的連線已刪除。

此時，通訊協定邊緣可以開始刪除埠。

可延伸交換器的通訊協定邊緣會在刪除可延伸交換器埠時遵循下列步驟：

可延伸交換器的通訊協定邊緣會發出 OID_SWITCH_PORT_TEARDOWN的 OID 集合要求。此 OID 要求會通知基礎可延伸交換器延伸模組有關可延伸交換器埠之刪除程式的開始。
通訊協定邊緣會在所有 OID 要求到可延伸交換器埠完成之後，發出 OID_SWITCH_PORT_DELETE 的 OID 集合要求。

注意如果延伸模組先前已呼叫 ReferenceSwitchPort 以遞增埠的參考計數器，則必須先呼叫 DereferenceSwitchPort ，通訊協定邊緣才會發出 OID_SWITCH_NIC_DELETE 要求。

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

延伸模組不得修改與 OID 要求相關聯的 NDIS_SWITCH_PORT_PARAMETERS 結構。
延伸模組必須一律將此 OID 集合要求轉送至基礎延伸模組。延伸模組不得讓要求失敗。
OID_SWITCH_PORT_DELETE要求完成NDIS_STATUS_SUCCESS之後，擴充功能將不會收到已刪除埠的任何封包或 OID 要求。延伸模組無法將封包轉送至已刪除的埠。擴充功能也無法發出 OID 要求，也無法針對已刪除的埠呼叫 ReferenceSwitchPort 函式。

注意可延伸的交換器擴充功能不得發出 OID 集合OID_SWITCH_PORT_DELETE要求。

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