OID_SWITCH_PORT_PROPERTY_ADD

Hyper-V 可延伸交換器的通訊協定邊緣會發出物件識別碼 (OID) 一組要求 OID_SWITCH_PORT_PROPERTY_ADD，以通知可延伸交換器延伸模組，以瞭解新增可延伸交換器埠的原則屬性。

NDIS_OID_REQUEST結構的InformationBuffer成員包含緩衝區的指標。此緩衝區包含下列資料：

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS結構，指定埠原則的參數識別和類型。
包含埠原則參數的屬性緩衝區。屬性緩衝區包含結構，該結構是以NDIS_SWITCH_PORT_PROPERTY_PARAMETERS結構的PropertyType成員為基礎。例如，如果 PropertyType 成員設定為 NdisSwitchPortPropertyTypeVlan，則屬性緩衝區會包含 NDIS_SWITCH_PORT_PROPERTY_VLAN 結構。

備註

轉送延伸模組可以處理OID_SWITCH_PORT_PROPERTY_ADD的 OID 集合要求。所有其他擴充功能類型都必須呼叫 NdisFOidRequest ，將 OID 要求轉送到可延伸交換器驅動程式堆疊中的下一個擴充功能。

延伸模組可以傳回 OID 要求的NDIS_STATUS_DATA_NOT_ACCEPTED，來加入埠屬性。例如，如果延伸模組無法配置資源，以在埠上強制執行其設定的原則，它應該已加入要求。

注意如果延伸模組傳回其他NDIS_STATUS_Xxx 錯誤狀態碼，則建立通知也會經過驗證。不過，傳回暫時案例的狀態碼，例如傳回NDIS_STATUS_RESOURCES，可能會導致建立通知重試。

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

如需如何處理 OID_SWITCH_PORT_PROPERTY_ADD OID 集合要求的指導方針，請參閱管理埠原則。

如果轉送延伸模組完成OID_SWITCH_PORT_PROPERTY_ADD的 OID 集合要求，它會傳回下列其中一個狀態碼：

狀態碼	描述
NDIS_STATUS_INVALID_LENGTH	資訊緩衝區的長度太小，無法處理結構NDIS_SWITCH_PORT_PROPERTY_PARAMETERS 結構和結構屬性緩衝區中的資料。延伸模組會設定DATA。SET_INFORMATION。NDIS_OID_REQUEST 結構中的 BytesNeeded成員，以達到所需的最小緩衝區大小。
NDIS_STATUS_DATA_NOT_ACCEPTED	轉送延伸模組已向埠原則新增通知。
NDIS_STATUS_NOT_SUPPORTED	轉送延伸模組不支援埠原則。
NDIS_STATUS_Xxx	OID 要求因其他原因而失敗。