OID_SWITCH_NIC_DISCONNECT
Hyper-V 可延伸交換器的通訊協定邊緣發出OID_SWITCH_NIC_DISCONNECT的對象標識碼 (OID) 集合要求,以通知基礎可延伸交換器擴充功能,指出可延伸交換器埠與網路適配器之間的連線正在中斷。 連線完全中斷之後,可延伸交換器的通訊協定邊緣將會發出 OID_SWITCH_NIC_DELETE的 OID 集合要求。
InformationBufferNDIS_OID_REQUEST 結構的成員包含 NDIS_SWITCH_NIC_PARAMETERS 結構的指標。
言論
NDIS_SWITCH_NIC_PARAMETERS 結構的 Index 成員會指定正在建立中斷連線通知之網路適配器的索引。 具有指定 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 狀態指示 NDIS_STATUS_SWITCH_NIC_STATUS。
注意 如果呼叫 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) |