共用方式為


OID_SWITCH_PORT_CREATE

Hyper-V 可延伸交換器的通訊協定邊緣會發出物件識別碼, (OID) 設定OID_SWITCH_PORT_CREATE要求,以通知可延伸交換器延伸模組建立可延伸交換器埠。

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

備註

NDIS_SWITCH_PORT_PARAMETERS結構的PortId成員會指定要建立通知的埠。

可延伸的交換器延伸模組必須遵循下列指導方針來處理OID_SWITCH_PORT_CREATE的 OID 集合要求:

  • 延伸模組不得修改與 OID 要求相關聯的 NDIS_SWITCH_PORT_PARAMETERS 結構。

  • 此延伸模組可以傳回 OID 要求的NDIS_STATUS_DATA_NOT_ACCEPTED,以取得建立通知。 例如,如果延伸模組無法配置資源,以在埠上強制執行其設定的原則,驅動程式應該已擁有建立通知。

    如果延伸模組傳回其他NDIS_STATUS_Xxx 錯誤狀態碼,則建立通知也會被核准。 不過,傳回暫時案例的狀態碼,例如傳回NDIS_STATUS_RESOURCES,可能會導致建立通知重試。

    如果擴充功能未通過 OID 要求,它應該會在要求完成時監視狀態。 延伸模組應該這樣做,以判斷 OID 要求是由可延伸交換器控制項路徑中的基礎延伸模組或可延伸交換器介面所驗證。

    如需埠原則的詳細資訊,請參閱 管理 Hyper-V 可延伸交換器原則

  • 如果擴充功能呼叫 NdisFOidRequest 轉送此 OID 集合要求,擴充功能應該監視此 OID 要求的完成狀態。 此擴充功能會偵測可延伸交換器驅動程式堆疊中的基礎延伸模組是否已通過埠建立通知。

  • 轉送 OID 要求並順利完成之後,延伸模組可以發出埠的 OID 要求,例如 OID_SWITCH_PORT_PROPERTY_ENUM,直到發出 OID_SWITCH_PORT_TEARDOWN 的 OID 要求為止。 此 OID 要求會通知延伸模組埠會從可延伸交換器開始刪除程式。

  • 延伸模組無法將封包轉送至NDIS_SWITCH_PORT_PARAMETERS結構中指定的埠 直到發出 OID_SWITCH_NIC_CONNECT 的 OID 集合要求並成功完成為止。

注意 擴充功能不得發出OID_SWITCH_PORT_CREATE的 OID 集合要求。

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

傳回狀態碼

如果延伸模組完成OID_SWITCH_PORT_CREATE的 OID 集合要求,它會傳回下列其中一個狀態碼。

狀態碼 描述

NDIS_STATUS_DATA_NOT_ACCEPTED

延伸模組已確認建立通知。

NDIS_STATUS_RESOURCES

延伸模組因資源狀況低而已取消建立通知。

NDIS_STATUS_Xxx

延伸模組因其他原因而已取消建立通知。

注意 如果延伸模組完成 OID 集合要求,它不得傳回NDIS_STATUS_SUCCESS。

如果擴充功能未完成OID_SWITCH_PORT_CREATE的 OID 集合要求,則要求會由可延伸交換器的基礎迷你埠邊緣完成。 基礎迷你埠邊緣會傳回此 OID 集合要求的下列狀態碼。

狀態碼 描述

NDIS_STATUS_SUCCESS

OID 要求已成功完成。

規格需求

版本

NDIS 6.30 和更新版本支援。

標頭

Ntddndis.h (包括 Ndis.h)

另請參閱


NDIS_OID_REQUEST

NDIS_SWITCH_PORT_PARAMETERS

NdisFOidRequest

OID_SWITCH_NIC_CONNECT

OID_SWITCH_PORT_ARRAY

OID_SWITCH_PORT_PROPERTY_ENUM