OID_SWITCH_NIC_DELETE
Hyper-V 可延伸交換器之通訊協定邊緣會發出OID_SWITCH_NIC_DELETE的物件標識碼 (OID) 集合要求給可延伸交換器驅動程式堆疊。 此 OID 要求會通知基礎可延伸交換器延伸模組有關刪除可延伸交換器埠與網路適配器之間的連線。 可延伸交換器的通訊協定邊緣先前會通知擴充功能,在發出 OID_SWITCH_NIC_DISCONNECT的 OID 集合要求時,正在刪除此連線。
InformationBufferNDIS_OID_REQUEST 結構的成員包含 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 集合要求都會指定不同的網路適配器連線索引值。 如需這些索引值的詳細資訊,請參閱 網路適配器索引值。
延伸模組必須維護每個基礎實體配接器的連線狀態。 如需實體網路適配器可以繫結至外部網路適配器之不同組態的詳細資訊,請參閱 實體網路適配器組態類型。
如需可延伸交換器埠和網路適配器連線狀態的詳細資訊,請參閱 Hyper-V 可延伸交換器埠和網路適配器狀態。
傳回狀態代碼
可延伸交換器的基礎迷你埠邊緣會完成OID_SWITCH_NIC_DELETE的 OID 查詢要求,並傳回下列狀態代碼。
狀態代碼 | 描述 |
---|---|
NDIS_STATUS_SUCCESS |
OID 要求已順利完成。 |
要求
版本 |
NDIS 6.30 和更新版本支援。 |
頁眉 |
Ntddndis.h (包括 Ndis.h) |