Hyper-V 可延伸交換器的通訊協定邊緣發出OID_SWITCH_PORT_PROPERTY_UPDATE的對象標識碼 (OID) 集合要求,以通知可延伸交換器延伸模組更新可延伸交換器埠原則的屬性。
InformationBufferNDIS_OID_REQUEST 結構的成員包含緩衝區的指標。 此緩衝區包含下列資料:
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。BytesNeededNDIS_OID_REQUEST 結構中的成員,以所需的緩衝區大小下限。 |
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