OID_SWITCH_PROPERTY_ADD

Hyper-V 可延伸交換器的通訊協定邊緣會發出物件識別碼 (OID) 設定OID_SWITCH_PROPERTY_ADD要求，以通知可延伸的交換器擴充功能，以通知交換器原則屬性的新增

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_ADD的 OID 集合要求。所有其他擴充功能類型都必須呼叫 NdisFOidRequest ，將 OID 要求轉送到可延伸交換器驅動程式堆疊中的下一個擴充功能。

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

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

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

如需如何處理 OID_SWITCH_PROPERTY_ADD OID 集合要求的指導方針，請參閱管理交換器原則。

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

狀態碼	描述
NDIS_STATUS_DATA_NOT_ACCEPTED	延伸模組已向交換器原則新增通知。
NDIS_STATUS_FAILURE	OID 要求因其他原因而失敗。

如果擴充功能未完成OID_SWITCH_PROPERTY_ADD的 OID 集合要求，則要求會由可延伸交換器的基礎迷你埠邊緣完成。迷你埠邊緣會傳回下列狀態碼。

狀態碼	描述
NDIS_STATUS_SUCCESS	OID 要求已成功完成。

版本	NDIS 6.30 和更新版本支援。
標頭	Ntddndis.h (包括 Ndis.h)