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)