Hyper-V 可扩展交换机的协议边缘发出OID_SWITCH_PROPERTY_ADD的对象标识符(OID)集请求,以通知可扩展交换机扩展添加开关策略属性
InformationBufferNDIS_OID_REQUEST 结构的成员包含指向缓冲区的指针。 此缓冲区包含以下数据:
指定可扩展交换机策略的标识和类型的 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) |