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