OID_SWITCH_PORT_DELETE
Hyper-V 可延伸交換器的通訊協定邊緣會發出OID_SWITCH_PORT_DELETE的對象識別碼 (OID) 集合要求,以通知可延伸交換器延伸模組刪除可延伸交換器埠。
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 以遞增埠的參考計數器,則必須在通訊協定邊緣發出 OID_SWITCH_NIC_DELETE 要求之前呼叫 DereferenceSwitchPort。
延伸模組必須遵循下列指導方針來處理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 可延伸交換器埠和網路適配器狀態。
傳回狀態代碼
可延伸交換器的基礎迷你埠邊緣會完成OID_SWITCH_PORT_DELETE的 OID 集合要求,並傳回下列狀態代碼。
狀態代碼 | 描述 |
---|---|
NDIS_STATUS_SUCCESS |
OID 要求已順利完成。 |
要求
版本 |
NDIS 6.30 和更新版本支援。 |
頁眉 |
Ntddndis.h (包括 Ndis.h) |