OID_SWITCH_PORT_PROPERTY_UPDATE
Hyper-V 可延伸交換器的通訊協定邊緣會發出物件識別碼 (OID) 集要求OID_SWITCH_PORT_PROPERTY_UPDATE,以通知可延伸交換器擴充功能更新可延伸交換器埠原則的屬性。
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_UPDATE的 OID 集合要求。 所有其他擴充功能類型都必須呼叫 NdisFOidRequest ,將 OID 要求轉送到可延伸交換器驅動程式堆疊中的下一個擴充功能。
延伸模組可以傳回 OID 要求的NDIS_STATUS_DATA_NOT_ACCEPTED,以取得埠屬性的更新。 例如,如果延伸模組無法配置資源,以在埠上強制執行其更新原則,它應該會保留更新要求。
注意 如果擴充功能傳回其他NDIS_STATUS_Xxx 錯誤狀態碼,更新通知也會受到確認。 不過,傳回暫時性案例的狀態碼,例如傳回NDIS_STATUS_RESOURCES,可能會導致重新嘗試建立通知。
如果延伸模組未通過 OID 要求,則應該監視要求完成時的狀態。 擴充功能應該這樣做,以判斷 OID 要求是由可延伸交換器控制項路徑或可延伸交換器介面中的基礎延伸模組所控制。
如需如何處理 OID_SWITCH_PORT_PROPERTY_UPDATE OID 集合要求的指導方針,請參閱 管理埠原則。
傳回狀態碼
如果轉送延伸模組完成OID_SWITCH_PORT_PROPERTY_UPDATE的 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 要求因其他原因而失敗。 |
如果擴充功能未完成OID_SWITCH_PORT_PROPERTY_UPDATE的 OID 集合要求,則要求會由可延伸交換器的基礎迷你埠邊緣完成。 迷你埠邊緣會傳回下列狀態碼。
狀態碼 | 描述 |
---|---|
NDIS_STATUS_SUCCESS |
OID 要求已順利完成。 |
規格需求
版本 |
NDIS 6.30 和更新版本支援。 |
標頭 |
Ntddndis.h (包含 Ndis.h) |
另請參閱
NDIS_SWITCH_PORT_PROPERTY_CUSTOM
NDIS_SWITCH_PORT_PROPERTY_PARAMETERS