OID_SWITCH_PROPERTY_UPDATE
Hyper-V 可延伸交換器的通訊協定邊緣發出OID_SWITCH_PROPERTY_UPDATE的對象標識碼 (OID) 集合要求,以通知可延伸交換器擴充功能更新至可延伸交換器原則屬性的參數。
InformationBufferNDIS_OID_REQUEST 結構的成員包含緩衝區的指標。 此緩衝區包含下列資料:
NDIS_SWITCH_PROPERTY_PARAMETERS 結構,指定可延伸交換器原則的識別和類型。
屬性緩衝區,包含可延伸交換器原則的參數。 屬性緩衝區包含結構,該結構是以 PropertyTypeNDIS_SWITCH_PROPERTY_PARAMETERS 結構的成員為基礎。
Note 從 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 |
延伸模組已否決交換器原則更新通知。 |
NDIS_STATUS_FAILURE |
OID 要求因其他原因而失敗。 |
如果延伸模組未完成 OID_SWITCH_PROPERTY_UPDATE 的 OID 集合要求,則此要求會由可延伸交換器的基礎迷你埠邊緣完成。 迷你埠邊緣會傳回下列狀態代碼。
狀態代碼 | 描述 |
---|---|
NDIS_STATUS_SUCCESS |
OID 要求已順利完成。 |
要求
版本 |
NDIS 6.30 和更新版本支援。 |
頁眉 |
Ntddndis.h (包括 Ndis.h) |